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Purpose of this Manual 



This guide provides you with in-depth informa- 
tion on the AT&T Personal Computer program 
development tools. The guide focuses on what 
you need to know to make use of the existing 
AT&T Personal Computer 6300 hardware and 
hardware interfaces. 

The final chapter on programming devices 
assumes that you have a working knowledge of 
the principles of designing device drivers and 
need the technical details on how to program the 
AT&T Personal Computer. 
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The following syntax is used throughout this 
manual in descriptions of command and state- 
ment syntax: 

[ ] Square brackets indicate that the enclosed 
entry is optional. 

{ } Braces indicate a choice between two or 
more entries. At least one of the entries 
enclosed in braces must be chosen. 

Ellipses indicate that an entry may be 
repeated as many times as needed. 

This guide contains examples of prompts and 
messages displayed on the screen. These system- 
displayed items are indented from the main 
body of the text so that you can easily distin- 
guish them. For example, MS-LINK prompts: 

OBJECT MODULES[.OBJ] 

Descriptions or examples that show a required 
response are indented and presented in boldface 
type: 

LINK OBJl-HOBJ2-i-OBJ3,iyiAP 
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This section shows where to go for information 
on the task you are performing. 



Running If you are running a program via the BASIC 

High-Level interpreter, the section on "System Calls" is 
Language applicable, since you can call these functions via 
a BASIC program. 



If you are running a compiled program, read the 
section on MS-LINK as well as the section on 
System Calls. 



Writing The first eight chapters are aimed at pro- 

Asisembler grammers writing assembler programs. If you 
Programs have not used the 8088 or 8086 assembly lan- 
guage, the section "8086 Addressing Scheme" 
gives you a good start. The sections on the linker 
and debugger are fundamental to writing and 
debugging assembler programs. Also read the 
sections on "System Calls" and "ROM BIOS 
Service Calls." 



Writing If you are writing a supplementary utility pro- 

Utilities gram, read the sections on assembly programs, 

the sections on "Memory Maps, Control Blocks, 
and Diskette Allocation," and "Program File 
Structure and Loading." 



Programming Every section applies to writing device drivers. 
Devices especially the chapter on "MS-DOS Device 

Directly Drivers." 
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• Overview 

• MS-LINK File Usage 

• Segments, Groups, and Classes 

• Invoking MS-LINK 

• Sample MS-LINK Session 

• MS-LINK Error Messages 
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Overview 



MS-LINK is an executable program on your 
DOS Supplemental Programs diskette. MS- 
LINK combines object modules that are the 
output of the MACRO-86 assembler or a 
compatible compiler. It produces a relocatable 
run file (load module) and a list file of external 
references and error messages. 

To run MS-LINK, you provide object, run, list, 
and library file parameters. You may optionally 
enter switches that modify the operation of 
MS-LINK. 

"Invoking the Linker" describes the three ways 
to run MS-LINK: interactive entry, command 
line entry, and automatic response file entry. 
Interactive entry is used most frequently, so its 
section contains information common to all 
three methods. 

If you are linking a high-level language 
program, the compiler determines the 
arrangement of your object modules in memory. 
If you are using assembler, however, you have 
more control over your program's organization. 
The section "Segments, Groups, and Classes" 
shows you how to specify the order of your 
object modules at run time. 
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MS-LINK File Usage 

The link process involves the use of several files. 
MS-LINK: 

• Works with one or more input files 

• Produces two output files 

• Creates a temporary disk file if necessary 

• Searches up to eight library files 
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The format for MS-LINK file specifications is 
the same as that of any disk file: 



Syntax [d:][path]filename[.ext] 

d: the drive designation. Permissible drive designa- 

tions for MS-LINK are A: through O:. 

path a path of directory names. 

filename any legal filename of one to eight characters. 

ext a one- to three-character extension to the 



filename. 

If no filename extensions are given in the input 
(object) file specifications, MS-LINK recognizes 
the following extensions by default: 

.OBJ Object 
.LIB Library 

MS-LINK appends the following default exten- 
sions to the output (Run and List) files: 

.EXE Run (may not be overridden) 
.MAP List (may be overridden) 
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VM.TMP File MS-LINK uses available memory for the link 
session. If an output file exceeds available 
memory, MS-LINK creates a temporary file, 
names it VM.TMP, and puts it on the disk in the 
default drive. If MS-LINK creates VM.TMP, it 
will display the message: 

VM.TMP has been created. 

Do not change diskette in drive, <d:> 

Once this message is displayed, do not remove 
the diskette from the default drive until the link 
session ends. If the diskette is removed, the 
operation of MS-LINK is unpredictable and MS- 
LINK usually displays the error message: 

Unexpected end of file on VM.TMP 

MS-LINK writes the contents of VM.TMP to the 
file named following the Run File: prompt. 
VM.TMP is a working file only and is deleted at 
the end of the linking session. 

Do not use VM.TMP as a filename for any file. 
If MS-LINK requires the VM.TMP file, MS- 
LINK deletes the VM.TMP already on disk and 
creates a new VM.TMP. Thus, the contents of 
the previous VM.TMP file are lost. 
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Changing You may want to change diskettes during the 
diskettes hnk operation. If MS-LINK cannot find an 

object file on the specified diskette, it prompts 
you to change diskettes rather than aborting the 
session. If you enter the /PAUSE switch, MS- 
LINK pauses and prompts you to change 
diskettes before it creates the run file. You may 
change diskettes when prompted except in the 
following cases: 

• the diskette you want to change has a VM.TMP 
file on it. 

• you have requested a list file on the diskette you 
want to change. 
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Segments, Groups, and Classes 



Below terms are explained to help you under- 
stand how MS-LINK works. Generally, if you 
are linking object modules from a high-level 
language compiler, you do not need to know 
these terms. If you are linking assembly lan- 
guage modules, read this section carefully. 



Segment The segment is one of the most basic units of 

program memory organization. A segment is a 
contiguous area of memory up to 64K bytes long, 
and may be located anywhere in RAM. The con- 
tents of a segment are addressed by a seg- 
ment:offset address pair, where "segment" is the 
segment's base or lowest address (see "The 20- 
Bit Address" in chapter 4). 

Each segment has a class name in addition to 
its segment name. All segments with the same 
class name are loaded into memory contiguously 
by the linker from the first segment of that class 
to the last. 



Class A class is a collection of related segments. By 

naming the segments of your assembly lan- 
guage program to classes, you control the order 
in which they are loaded into memory (for high 
level languages, the compiler does this for you). 

MS-LINK loads segments into memory on a 
class-by-class basis. Starting with the first class 
encountered in the first object file, all of the 
segments of each class are loaded. Within each 
class, the linker loads the segments in the order 
in which it finds them in the object files. There- 
fore, you can control the order in which classes 
are loaded by the order in which segments from 
different classes appear in the object files. 
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To ensure that classes are loaded in the order 
you desire, you can create a dummy module to 
feed to the linker as the first object file. This 
module declares empty-segment classes in the 
order you want the classes loaded. For example, 
one such file might look like this: 



A 


SEGMENT 'CODE' 


A 


ENDS 


B 


SEGMENT 'CONST' 


B 


ENDS 


C 


SEGMENT 'DATA' 


C 


ENDS 


D 


SEGMENT STACK 'STACK' 


D 


ENDS 



If this method is used, be sure to declare all the 
classes used in your program in the dummy 
module; otherwise, you lose absolute control over 
the ordering of classes. Also, this method should 
only be used when linking assembly language 
programs. Do not create a dummy module if link- 
ing object files for a compiler, or unpredictable 
results may occur. Classes may be any length. 

Group Just as classes allow you to combine segments 

in a way that is logical, groups combine seg- 
ments in 64K byte chunks to make them easily 
addressable. The segments in a group need not 
be contiguous, but when loaded they must fit 
within 64K bytes. This way each segment in the 
group can be fully addressed by an offset to one 
segment address, which is the start address of 
the lowest segment in the group. Segments are 
named to groups by the assembler or compiler 
or, as is possible in assembly language pro- 
grams, by the programmer. Note that a segment 
can be large enough to be an entire group by 
itself. 
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Invoking MS-LINK 



Ways 

to Invoke 

MS-LINK 



Interactive 
Entry 



MS-LINK is invoked in one of three ways. The 
first method, interactive entry, requires you to 
respond to individual prompts. 

For the second method, command Hne entry, 
type all commands on the same line used to start 
MS-LINK. 

To use the third method, automatic response file 
entry, create a response file that contains all the 
necessary commands and tell MS-LINK where 
that file is when you run MS-LINK. 

Interactive Entry LINK 

Command Line Entry LINK filenames[/switches] 
Automatic Response 

File Entry LINK @filespec 

To invoke MS-LINK interactively, type: 
LINK 

MS-LINK loads into memory, then displays four 
prompts, one at a time. At the end of each line, 
after typing your response to the prompt, you 
may type one or more switches preceded by a 
forward slash. 

The command prompts are summarized below. 
Defaults appear in square brackets ([]) after the 
prompt. Object Modules is the only prompt that 
requires a response. 
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MS-LINK Prompt Responses 

Prompts 

Object Modules[.OBJ]: [d:][path]filename[.ext] 

[+[[d:][path]filename[.ext]]...] 

Run File[filename.EXT]: [d:][path][filename[.ext]] 

List File[NUL.MAP]: [d:][path][filename[.ext]] 

Libraries[.LIB]: [d:][path][filename[.ext]] 

[+[d:][[path]filename[.ext]]...] 

Notes: 

• If you enter a filename without specifying the 
drive, the default drive is assumed. If you enter a 
filename without specifying the path, the default 
path is assumed.The libraries prompt is an 
exception — if the linker looks for the libraries 
on the default drive and doesn't find them, it 
looks on the drive specified by the compiler. 

• To select default responses to all remaining 
prompts, use a single semicolon (;) followed 
immediately by <return> at any time after the 
second prompt (Run File:). 

Once you enter the semicolon, you can no longer 
respond to any of the prompts for that link ses- 
sion. Use the <RETURN> key to skip prompts. 

• Use <CONTROL-C> to abort the link session at 
any time. 
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Object 
Modules 
to be 
Included 



Object Modules [.OBJ]: 

List .OBJ files to be linked. They must be separ- 
ated by blank spaces or plus signs (+). If the plus 
sign is the last character typed, this prompt will 
reappear so that you can enter more object 
modules. 



MS-LINK assumes that object modules have the 
extension .OBJ unless you explicitly specify 
some other extension. Object filenames may not 
begin with the @ symbol (@ is used for specify- 
ing an automatic response file). 

The order in which you key in the the object files 
is significant. See section on segments, groups, 
and classes for more information. 



Load 
Module 



Run File [Obj-file.EXE]: 

Give filename for executable object code. The 
default is: <first-object-filename>.EXE. (You 
cannot change the output extension.)You can 
specify just the drive designation or just a path 
for this prompt. 



Listing 



List File [NUL.MAP]: 

Give filename for listing (also known as a linker 
map). The listing is not created if you select the 
default. You can request a listing by entering a 
drive designator, path, or filename[.ext]. If you 
do not specify an extension, the default .MAP is 
used. 
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You can have the listing printed by specifying a 
print device instead of a filename or have the 
listing displayed on the screen by specifying 
CON. If you display the linker map, you can 
also print it by pressing Ctrl-PrtSc. 



Libraries Libraries [.LIB]: 

to be 

Searched List filenames to be searched separated by blank 
spaces or plus signs (+). If a plus sign is the last 
character typed, the prompt will reappear. 

MS-LINK searches library files in the order 
listed to resolve external references. When it 
finds the module that defines the external sym- 
bol, MS-LINK processes that module as another 
object module. 

There is no default library search for MACRO 
assembler object modules. For compiled 
modules, if you select the default for this prompt, 
MS-LINK looks for the compiler package's 
library on the default drive. If not found there, 
MS-LINK looks on the drive specified by the 
compiler. 

If MS-LINK cannot find a library file, it 
displays: 

Cannot find library <library-name> 
Type new drive letter: 

Press the letter for the drive designation (for 
example, B). 

If two libraries have the same filename, only the 
first in the list is searched. 
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MS-LINK 
Switches 



The seven MS-LINK switches control various 
MS-LINK functions. Type switches at the end of 
a prompt response regardless of which method 
you use to start MS-LINK. Switches may be 
grouped at the end of any response, or may be 
scattered at the end of several. Even if you type 
more than one switch at the end of one response, 
each switch must be preceded by a forward slash 



All switches may be abbreviated. The only re- 
striction is that an abbreviation must be sequen- 
tial from the first letter through the last typed; 
no gaps or transpositions are allowed. For 
example: 

Legal Illegal 



(/). 



/D 

/DS 

/DSA 

/DSALLOCA 



/DSL 
/DAL 
/DLC 



/DSALLOCT 
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/DSALLOCATE 

/DSALLOCATE tells MS-LINK to load all data 
at the high end of the Data Segment. Otherwise, 
MS-LINK loads all data at the low end of the 
Data Segment. At runtime, the DS pointer is set 
to the lowest possible address to allow the entire 
DS segment to be used. Use of /DSALLOCATE 
in combination with the default load low (that 
is, the /HIGH switch is not used) permits the 
user application to dynamically allocate any 
available memory below the area specifically 
allocated within DGroup yet to remain address- 
able by the same DS pointer. This dynamic allo- 
cation is needed for Pascal and FORTRAN 
programs. 

Your application program may dynamically 
allocate up to 64K bytes (or the actual amount of 
memory available) less the amount allocated 
within DGroup. 

/HIGH /HIGH causes MS-LINK to place the Run file as 

high as possible in memory. Otherwise, MS- 
LINK places the Run file as low as possible. 

Note: 

Do not use /HIGH with Pascal or FORTRAN 
programs. 
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/LINENUMBERS 

/LINENUMBERS tells MS-LINK to include in 
the List file the line numbers and addresses of 
the source statements in the input modules. 
Otherwise, line numbers are not included in the 
List file. 

Not all compilers produce object modules that 
contain line number information. In these cases, 
of course, MS-LINK cannot include line 
numbers. 



/MAP /MAP directs MS-LINK to hst all pubhc (global) 

symbols defined in the input modules. If /MAP 
is not given, MS-LINK will list only errors 
(including undefined globals). 

The symbols are Hsted alphabetically. For 
each symbol, MS-LINK lists its value and its 
segment:offset location in the Run file. The 
symbols are listed at the end of the List file. 



/PAUSE /PAUSE causes MS-LINK to pause in the link 

session when the switch is encountered. Nor- 
mally, MS-LINK performs the linking session 
from beginning to end without stopping. This 
switch enables you to swap the diskettes before 
MS-LINK outputs the Run (.EXE) file. 
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When MS-LINK encounters /PAUSE, it dis- 
plays the message: 

About to generate .EXE file 
Change disks <hit any key> 

MS-LINK resumes processing when you press 
any key. 

Note 

Do not remove the disk which will receive the 
List file, or the disk used for the VM.TMP file, if 
one has been created. 



/STACK: Stack number represents any positive numeric 
<nUmber> value (in hexadecimal radix) up to 65536 bytes. 

If a value from 1 to 511 is typed, MS-LINK will 
use 512. If /STACK is not used for a link ses- 
sion, MS-LINK calculates the necessary stack 
size automatically. 

All compilers and assemblers should provide 
information in the object modules that allow the 
linker to compute the required stack size. 

At least one object (input) module must contain 
a stack allocation statement. If not, MS-LINK 
will display the following error message: 

WARNING: NO STACK STATEMENT 
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/NO /NO is short for NODEFAULTLIBRARY- 

SEARCH. This switch appHes only to higher 
level language modules. This switch tells MS- 
LINK not to search the default libraries in the 
object modules. For example, if you are linking 
object modules in Pascal, specifying /NO tells 
MS-LINK not to automatically search the 
library named PASCAL.LIB to resolve external 
references. 
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Purpose 

Syntax 

obj-list 

runfile 
listfile 
lib-list 

/switch 



You may invoke MS-LINK by typing all com- 
mands on one line. The entries following LINK 
are responses to the command prompts. The 
entry fields for the different prompts must be 
separated by commas. Use the following syntax: 



LINK <obi -list>,<runf ile>,<listf ile>, 
<lib-list>[/switch...] 



a list of object modules, separated by plus signs 
or spaces. 

name of the file to receive the executable output. 



name of the file to receive the listing. 



list of library modules to be searched, separated 
by spaces or plus signs. 



refers to optional switches which may be placed 
following any of the response entries (just before 
any of the commas or after the <lib-list>, as 
shown). 

To select the default for a field, simply type a 
second comma with no spaces between the two 
commas. 
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Example: 

LINK FUN+TEXT+TABLE+CARE, 
FUNLIST, COBLIB.LIB 

This command causes MS-LINK to load. Then 
the object modules FUN.OBJ, TEXT.OBJ, 
TABLE.OBJ and CARE.OBJ are loaded. MS- 
LINK links the object modules and writes the 
output to FUN.EXE (by default), creates a List 
file named FUNLIST.MAP, and searches the 
library file COBLIB.LIB. 



Automatic It is often convenient to save responses to the 
Response linker for re-use at a later time. This is especially 
File useful when a long list of object modules needs 

Entry to be specified. The use of an automatic response 

file allows you to do this. 

Before using this option, you must create the 
response file. Each line of text corresponds to 
one MS-LINK prompt. The responses must be 
typed in the same order as they are when 
entered interactively. To continue a line, type a 
plus sign (+) at the end of the line. 

You can enter the name of more than one auto- 
matic response file on the command line and 
combine response file names with additional 
parameters. The combined series of resulting 
parameters must be a valid sequence of MS- 
LINK prompts. 

Use switches and special characters (+ and ;) in 
the response file the same way they are used 
when entered interactively. 
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To invoke the linker using a response file, type 

LINK @ <filespec> 
Filespec is the name of a response file. 

When the session begins, MS-LINK displays 
each prompt with the corresponding response 
from the response file. If the response file does 
not contain answers for all the prompts, MS- 
LINK displays the prompt which does not have 
a response and waits for a response. When you 
type a legal response, MS-LINK continues the 
link session. 

Example: 

FUN TEXT TABLE CARE 
/PAUSE /MAP 
FUNLIST 
COBLIB.LIB 

This response file tells MS-LINK to load the four 
object modules named FUN.OBJ, TEXT.OBJ, 
TABLE.OBJ, and CARE.OBJ. MS-LINK pauses 
before producing a public symbol map to permit 
you to swap disks. When you press any key, the 
output files will be named FUN.EXE and 
FUNLIST.MAP. MS-LINK will search the 
library file COBLIB.LIB. 
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Sample MS-LINK Session 



This sample shows you the type of information 
displayed during an MS-LINK session. 

In response to the MS-DOS prompt, type: 
LINK 

The system displays the following messages and 
prompts: 

Microsoft Object Linker V2.01 (Large) 
(C) Copyright 1982,1983 by Microsoft Inc. 

Object Modules [.OBJ]: lO SYSINIT 
Run File [lO.EXE]: 

List File [NULMAP]: PRN /MAP /LINE 
Libraries [.LIB]: ; 

Notes: 

• By specifying /MAP, you get both an alphabetic 
listing and a chronological listing of public 
symbols. 

• By responding PRN to the List File: prompt, you 
can redirect your output to the printer. 

• By specifying the /LINE switch, MS-LINK 
gives you a listing of all line numbers for all 
modules. (Note that /LINE can generate a large 
volume of output.) 
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Once MS-LINK locates all libraries, the linker 
map displays a list of segments in the order of 
their appearance within the load module. The 
list might look like this: 

Start Stop Length Name 

OOOOOH 009ECH 09EDH CODE 
009F0H 01166H 0777H SYSINITSEG 

The information in the Start and Stop columns 
shows the 20-bit hex address of each segment 
relative to location zero. Location zero is the 
beginning of the load module. 

The addresses displayed are not the absolute 
addresses where these segments are loaded. See 
the following section on the MS-LINK DEBUG 
program for information on how to determine 
the absolute address of a segment. 
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Because the /MAP switch was used, MS-LINK 
displays the pubUc symbols by name and value. 



For example: 




ADDRESS 


PUBLICS BY NAME 


009F:0012 


BUFFERS 


009F:0005 


CURRENT DOS LOCATION 


009F:0011 


DEFAULT DRIVE 


009F:000B 


DEVICE LIST 


009F:0013 


FILES 


009F:0009 


FINAL DOS LOCATION 


009F:000F 


MEMORY SIZE 


009F:0000 


SYSINIT 


ADDRESS 


PUBLICS BY VALUE 


009F:0000 


SYSINIT 


009F:0005 


CURRENT DOS LOCATION 


009F:0009 


FINAL DOS LOCATION 


009F:000B 


DEVICE LIST 


009F:000F 


MEMORY SIZE 


009F:0011 


DEFAULT DRIVE 


009F:0012 


BUFFERS 


009F:0013 


FILES 



The final line in the listing file describes the 
program's entry point: 

Program entry point at 0009F:0000 
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MS-LINK Error Messages 



All errors, except for the two warning messages, 
cause the link session to abort. After the cause 
has been found and corrected, MS-LINK must be 
rerun. The following error messages are 
displayed by MS-LINK: 

Attempt to access data outside of segment bounds, 
possibly bad object module 

There is probably a bad object file. 

Bad numeric parameter 

Numeric value is not in digits. 

Cannot open temporary file 

MS-LINK is unable to create the file VM.TMP 
because the disk directory is full. Insert a new 
disk. Do not remove the disk that will receive the 
List. MAP file. 



Error: dup record too complex 

DUP record in assembly language module is too 
complex. Simplify DUP record in assembly lan- 
guage program. 
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Error: fixup offset exceeds field width 

An assembly language instruction references an 
address with a short or near instruction instead 
of a long or far instruction. Edit assembly 
language source and reassemble. 

Input file read error 

There is probably a bad object file. 

Invalid object module 

An object module(s) is incorrectly formed or 
incomplete (as when assembly is stopped in the 
middle). 



Symbol defined more than once 

MS-LINK found two or more modules that 
define a single symbol name. 



Program size or number of segments exceeds capacity of 
linker 

The total size may not exceed 384K bytes and 
the number of segments may not exceed 255. 

Requested stack size exceeds 64K 

Specify a size less than or equal to 64K bytes 
with the /STACK switch. 



2-25 



MS-LINK 



Segment size exceeds 64K 

64K bytes is the addressing system limit. 

Symbol table capacity exceeded 

Very many and/ or very long names were typed 
exceeding the limit of approximately 50K bytes. 

Too many external symbols in one module 

The limit is 256 external symbols per module. 

Too many groups 

The limit is ten groups. 

Too many libraries specified 

The limit is 8 libraries. 

Too many public symbols 

The limit is 1024 public symbols. 

Too many segments or classes 

The limit is 256 (segments and classes together 
must total 256 or less). 
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Unresolved externals: <list> 

The external symbols listed have no defining 
module among the modules or library files 
specified. 

VM read error 

This is a disk error; it is not caused by 
MS-LINK. 



Warning: no stack segment 

None of the object modules specified contains a 
statement allocating stack space. 

Warning: segment of absolute or unknown type 

There is a bad object module or an attempt has 
been made to link modules that MS-LINK 
cannot handle (e.g., an absolute object module). 



Write error in TMP file 

No more disk space remains to expand the 
VM.TMP file. 



Write error on run file 

Usually, this means there is not enough disk 
space for the Run file. 
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Overview 



The DEBUG utility is an executable object program 
that resides on your MS-DOS diskette. DEBUG per- 
forms the following functions: 

• Allows you to single step through a program, instruc- 
tion by instruction, for testing purposes. 

• Changes register and file contents during the 
DEBUG session so that you can test a code change 
without reassembling your program. 

• Makes permanent changes to diskette files so you can 
use DEBUG to recover files that may otherwise be 
lost. 

• Supports a disassemble command so you can 
translate machine code instructions into their assem- 
bly language equivalents for testing purposes. 
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How to Invoke DEBUG 



The DEBUG program is invoked as follows: 
DEBUG [filespec [,arglist]] 



filespec the name of the program file to be debugged. 



arglist An optional list of file name parameters and 

switches. These will be passed to the program 
specified by the filespec parameter. When the 
program is loaded into memory, it is loaded as if 
it had been invoked with the command 

filespec arglist 

That is, filespec indicates the file to be debugged, 
and arglist is the rest of the command line that 
is used when the file is invoked and loaded in 
memory via C0MMAND.COM. 

If you enter DEBUG without parameters, since 
no file name has been specified, current memory, 
disk blocks, or disk files can be manipulated. 



3-3 



DEBUG 



Comments On entering the DEBUG environment DEBUG 
responds with the hyphen (-) prompt and under- 
hne (_) cursor. You now may enter any DEBUG 
command. 

If you include the filespec in the command Hne, 
the specified file is loaded into memory starting 
at location 100 (hexadecimal). However, if you 
specify a file with a .EXE extension, the pro- 
gram is relocated to the address specified in the 
header of the file. See the chapter on "Program 
Structure and Loading" for information on the 
format of the file header. 

If the file has the HEX extension, the file is 
loaded beginning at the address specified in the 
HEX file. HEX files are in INTEL hex format 
and are converted to memory image format by 
DEBUG. 

All DEBUG commands may be aborted at any 
time by pressing <CTRL-C>. Pressing 
<CTRL-S> suspends the display, so that you 
can read it before the output scrolls away. After 
suspending the display, press any key (except 
<CTRL-S> or <CTRL-C» to continue scrolhng, 



Examples DEBUG <CR>. 

The DEBUG session begins, but without loading 
a file. 

DEBUG b:myprog <CR>. 

The DEBUG environment is entered and the file 
named "myprog" is loaded into memory from 
drive B. 
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When you invoke DEBUG, it sets up a program 
segment prefix at offset in the program work 
area. You can overwrite this area if you enter 
DEBUG without parameters. Moreover, if you 
are debugging a file with a COM or EXE exten- 
sion, do not tamper with the program header 
below location 5CH, or DEBUG will terminate. 

Do not restart a program after a "Program ter- 
minated normally" message is displayed. You 
must reload the program with the N and L 
commands for it to run properly. 
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Debugging Commands 



This section describes the DEBUG commands in 
alphabetical order for ease of reference. 

Commands can be entered in either upper or 
lower case. 

Command keywords and command parameters 
can be separated from each other by spaces or 
commas for readability but need not be, except 
where two hexadecimal numbers are entered as 
parameters, in which case they must be sepa- 
rated by a comma or space. For brevity, the syn- 
tax of this chapter will always indicate a comma 
where separation is obligatory, but note that a 
space can alternatively be used. 

Commands only become effective after entering 
<CR>. 

If you make a syntax error when entering a 
command, the message "Error" will be dis- 
played. You must re-enter the command using 
the correct syntax. 
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Command Parameters 



The following DEBUG command parameters 
require definition. 



address a hex value in one of the following formats: 

• a segment register designation and a hex offset 
separated from each other by a colon. For 
example: 

DS:0300 

• a hexadecimal segment and offset separated 
from each other by a colon. For example: 

9D0:0100 

• a hexadecimal offset value. The DEBUG 
command will use a default segment value from 
either the DS or CS registers, depending on the 
command. For example: 

200 



byte 
drive 



a one or two character hexadecimal value. 



0, 1, or 2 depending on whether you wish to 
select drive A, drive B or drive C, respectively. 
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range a range of addresses. The range can be specified 

as 

address L value 

where address specifies the start of the range and 
value specifies the length of the range. For 
example: 

DS:300L30 

indicates a range of 48 locations starting at 
address 300 in the segment indicated by the DS 
register. 

The specified range cannot be greater than 10000 
(hexadecimal). To specify this value enter 0000 (or 
0) as the value parameter. 

A range can also be specified as: 

address, address 

where the two addresses indicate the limits of the 
range. A space may be used instead of a comma. 



value a 1 to 4 character hexadecimal value. 
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A (ASSEMBLE) 



Assembles 8086 mnemonics directly into 
memory. 

Syntax A [address] 

Address is the start address into which the sub- 
sequently entered line of mnemonics is to be 
assembled. If this parameter is omitted, offset 
100 from the segment in the CS register is 
assumed, if you did not enter an Assemble 
command previously. If you did enter Assemble 
previously, the code assembles into the address 
following the last instruction loaded by the pre- 
vious Assemble command. 

Comments • After you enter the Assemble command, 

DEBUG displays the specified address followed 
by the cursor. You may then enter a line of 8086 
assembler mnemonics. On terminating the line 
with <CR>, the line will be assembled into 
memory starting at the specified location. The 
address of the byte subsequent to the assembled 
code will be displayed on the next line along 
with the cursor to enable you to enter the next 
line of code. If, instead of a line of 8086 mnemon- 
ics, you simply enter <CR>, the Assemble com- 
mand terminates and the DEBUG prompt 
reappears. 

• All numeric values are hexadecimal and must be 
entered as 1 to 4 characters without a trailing H. 
Prefix mnemonics must be specified in front of 
the opcode to which they refer. You may also 
enter them on a separate line. 

• The segment override mnemonics are CS:, DS:, 
ES: and SS:. The mnemonic for the far return is 
RETF. String manipulation mnemonics must 
explicitly state the string size. For example, use 
MOVSB to move byte strings. 
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The Assemble command will automatically 
assemble short, near, or far jumps and calls, 
depending on byte displacement with respect to 
the destination address. These may be overrid- 
den with the NEAR or FAR prefix. For example: 

1 00:0500 JMP 502 ; a two-byte 

;short jump 

1 00:0502 JMP NEAR 505 ;a three-byte 

;near jump 

1 00:505 JMP FAR 50A ; a five-byte far 

;juinp 

The NEAR prefix may be abbreviated to NE, 
but the FAR prefix cannot be abbreviated. 

DEBUG cannot tell whether some operands 
refer to a word memory location or to a byte 
memory location. In this case the data type must 
be explicitly stated with the prefix "WORD 
PTR" or "BYTE PTR". Acceptable abbrevia- 
tions are "WO" and "BY". For example: 

NEG BYTE PTR [128] 
DEC WO [SI] 

DEBUG cannot distinguish whether an operand 
refers to a memory location or to an immediate 
operand. Enclose operands that refer to memory 
locations in square brackets. For example: 



MOV AX,21 
MOV AX,[21] 



Load AX with 21H 

Load AX with the contents of 

location 21H 



DEBUG 



• Two pseudo-instructions are available with the 
Assemble command. The DB opcode will assem- 
ble byte values directly into memory. The DW 
opcode assembles word values into memory. For 
example: 

DB 1,2,3,4,'THIS IS AN EXAMPLE" 
DB 'THIS IS A QUOTE:" ' 
DB "THIS IS A QUOTE' " 
DW 1000,2000,3000,"BACH" 

• The Assemble command supports all forms of 
register indirect addressing. For example: 

ADD BX,34[BP-t-2]. [SI-1] 
POP [BP-i-DI] 
PUSH [SI] 

All opcode synonyms are supported. For 
example: 

LOOPZ 100 

LOOPE 100 

JA 200 

JNBE 200 
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Example 1 Enter A200 <CR>. 

2 DEBUG displays 09AC:0200_ . 

3 Enter MOV AX,[2 1 ] <CR>. 

4 The 8086 mnemonics are assembled starting at 
location 200. The byte location subsequent to the 
assembled code is then displayed: 

09AC:0203_ 

5 Enter <CR>. 

6 The Assemble command terminates and the 
DEBUG prompt reappears. 
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C (COMPARE) 



Compares the contents of two areas of memory. 



Syntax C range,address 



range the range of addresses defining the first area to 

be compared. If no segment is specified, then the 
segment specified in the DS register is assumed. 



address the start of the area to be compared with the 

area specified by the range parameter. 



Comments • The Compare command compares the area of 
memory specified by the range parameter with 
an area of the same size starting at the location 
specified by the address parameter. 

• If the contents of the two areas are identical, 
nothing is displayed. If there are differences, 
then the differences are displayed in the form 

<addressl> <contentsl> <contents2> <address2> 

<addressl> indicates the address in the first 
area and <contentsl> its contents. <address2> 
indicates the corresponding address in the 
second area and <contents2> its contents. 
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Enter C 100, 1FF,300 <CR> or 
C100L100,300<CR>. 

The area of memory from 100 to IFF is com- 
pared with the area of memory from 300 to 3FF. 
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D (DISPLAY) 



Displays an area of memory. 



Syntax 



D [range] or 
D [address] 



range 



tlie range of addresses wliose contents are to be 
displayed. If you enter only offsets, then the 
segment specified in the DS register is assumed. 



address the address from which the display is to start. 

The contents of this address and the subsequent 
127 locations are displayed. If only an offset is 
entered, then the segment specified in the DS 
register is assumed. 



Comments • 



If D is specified without parameters, then the 
128 bytes following the last address to be dis- 
played are displayed. If no location has yet been 
accessed, the display will start from location 
DS:100. 

If D and the range parameter are specified, the 
contents of that range of addresses are dis- 
played. If this takes more than 24 screen lines, 
the display is scrolled until the contents of the 
final address in the range are displayed on line 
24. 

The display is displayed in two portions: 

A hexadecimal display, where each byte is 
represented by its hexadecimal value, and an 
ASCII display, where the equivalent ASCII 
character for the byte is displayed. If there is no 
corresponding printable ASCII character, a 
period (.) is displayed. 
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Each line of the display begins with an address 
followed by the hexadecimal contents of the 16 
bytes starting from the addressed location. The 
eighth and ninth bytes are separated by a 
hyphen (-). The right-hand columns display the 
equivalent ASCII values. Each line of the dis- 
play, except possibly the first, begins on a 16 
byte boundary. 



Example 1 Enter D 1 00, 1 1 <CR>. 

2 Lines lOOH to llOH (inclusive) are displayed. 

3 Enter D <CR>. 

4 The 128 bytes starting from location lllH are 
displayed. 

5 Enter D200<CR>. 

6 The 128 bytes starting from location 200H are 
displayed. 
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E (ENTER) 







Replaces the contents of memory locations at 
the byte address(es) specified. 


Syntax 




E address[,bytevalue[,bytevalue...]] 


address 




the address of the location whose value is to be 
replaced; or the address of the first of a succes- 
sion of locations whose contents are to be 
replaced. If only an offset is specified, then the 
segment indicated by the DS register is 
assumed. 


AT "i" A XT' £1 1 1 1 o 




the value that is to replace the contents of the 
specified address. The first bytevalue parameter 
will replace the contents of the location specified 
by the address parameter. A second bytevalue 
will replace the contents of the location follow- 
ing that specified by the address parameter, and 
so on. 


Comments 


• 


If the command is entered without the byte 
value list, then DEBUG displays the specified 
address and its contents. The Enter command 
then waits for you to perform one of the 
following: 




1 


Replace the displayed bytevalue by entering 
another value. Enter the new value after the cur- 
iciiL vdiuc. li yuu cxiLci dii Illegal vaiue, or ii you 
type more than two di^;. 's, the illegal or extra 
character is not echoed. 




2 


Advance to the next byte by pressing 
<SPACE>. To change the value of this byte 
simply enter the value as described above. If you 
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advance beyond an eight-byte boundary, 
DEBUG starts a new display line with the 
address displayed at the start of the line. To 
advance to the next byte without changing the 
current byte, press <SPACE> again. 

3 To return to the previous byte enter hyphen (-). 
DEBUG then starts a new display line with the 
address of the byte you have returned to and its 
contents. You can then change the contents of 
this location as described above. To move back 
one byte further without changing this value, 
enter hyphen again, and another new display 
line will be generated. 

4 Terminate the Enter command by pressing 
<CR>. This key may be pressed in any byte 
position. 

• If you specify byte values in the command line, 
then the first of these byte values will replace 
the contents of the location specified by the 
address parameter. Subsequent entries in the list 
of byte values will replace subsequent bytes in 
memory. 



Example 1 Enter E 1 00 <CR>. 



2 DEBUG displays something like 058D:0 1 00 
CD._ 

3 Enter 26. 

4 the value of location 100 is changed to 26 and 
DEBUG displays: 

0580:0100 CD.26_ 
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5 Enter <SPACE>. 

6 The next byte (location 101) is displayed 

058D:0100 CD.26 20._ 

7 Enter <SPACE>. 

8 The next byte (location 102) is displayed 

058D:100 CD.26 20. 00._ 

9 Enter <->. 

10 The previous byte (location 101) is displayed on 
the next line 

058D:0100 CD.26 20. 00. 
058D:0101 20._ 

11 Enter 30 <CR>. 

12 The contents of location 101 are changed to 30 
and the Enter command is terminated. 

058D:0100 CD.26. 20. 00. 
058D:0101 20.30 

1 3 Enter E 200,26,0A, 1 9,23 <CR>. 

14 The contents of byte locations 200, 201, 202 
and 203 are changed to 26, OA, 19 and 23, 
respectively. 



3-19 



DEBUG 



F (FILL) 



Fills an area of memory with specified byte 
values. 

Syntax F range,bytevalue[,bytevalue...] 

range the range of addresses whose contents are to be 

overwritten with the specified byte values. If only 
the offset is specified, then the segment indi- 
cated by the DS register is assumed. 



bytevalue a two digit hexadecimal value that is to over- 
write the contents of the specified address(es). 



Comments • If the specified range contains more bytes than 
the list of byte values, then the list of byte values 
is repeated until the specified range is filled. 

• If the list of byte values is longer than the speci- 
fied range, the extra byte values are ignored. 



Example 1 Enter F04BA: 1 OOL 1 00,42,45,48,37,20 <CR>. 

2 DEBUG fills memory locations 04BA: 1 00 to 
04BA:1FF with the byte values specified. The 
five values are repeated until all 256 locations 
are filled. 



3-20 



DEBUG 



G(GO) 



Syntax 



Executes the program currently in memory, 
optionally halting at specified breakpoint(s) and 
displaying information about the system and 
program environment. 

G [=address][, address...] 



= address the address in memory at which program execu- 

tion is to start. must be entered to distin- 
guish a start address from a breakpoint address. 



address the breakpoint address. You can specify up to 

ten breakpoints, in any order. 



Comments 



If you enter G without parameters, the program 
currently in memory is executed starting from 
the address specified by the CS and IP registers. 

If you specify the ^address parameter, the con- 
tents of the CS and IP registers are changed to 
those specified by the ^address parameter and 
the program in memory is executed, starting 
from the address you specified. 

If you specify one or more breakpoint addresses, 
program execution stops at the first such 
address encountered and displays the contents 
of the registers, the state of the flags and the 
next instruction to be executed (see the Register 
command for a description of the display). 

• If only an offset is entered for an address, the 
GO command assumes the segment in the CS 
register. 
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If you enter more than ten breakpoints, DEBUG 
will display 

BP Error 

Before executing the program, the GO command 
replaces the contents of the breakpoint locations 
with an interrupt instruction (hexadecimal CC). 
Therefore, each breakpoint address that you 
specify must point to the first byte of an 8086 
instruction, or unpredictable results occur. 

When program execution halts at a breakpoint 
DEBUG restores the original values of all the 
specified breakpoint locations. However, if the 
program terminates normally (that is, not at a 
specified breakpoint), the original values are not 
restored. 

Note: Once a program has reached completion 
(DEBUG has displayed "Program terminated 
normally") you must reload the program before 
you can re-execute it. 

The stack segment must have six bytes avail- 
able at the stack pointer for this command, 
otherwise unpredictable results occur. This is 
because the GO command jumps into the user 
program with the IRET instruction. The flag, 
CS, and IP registers have to be pushed onto the 
stack in preparation for the IRET, taking up six 
bytes. 
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Example 1 Enter G=200,1AF, 14 1<CR>. 

2 The program currently in memory is executed 
starting from location 200. Assuming location 
141 is encountered before lAF, then the program 
halts at location 141 and the register and flag 
values are displayed along with the next 
instruction to be executed. If neither breakpoint 
location is encountered, then the program ter- 
minates normally. 

3 Enter G <CR>. 

4 If, in step two, the program had halted at 
location 141, then program execution continues 
from that address. 
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H (HEXARITHMETIC) 



Syntax 
value- a 
value_b 



Calculates and displays the sum and the differ- 
ence of two hexadecimal values. 

H value_a,value_b 



The first of two hexadecimal values. 



The hexadecimal value that is to be added to or 
subtracted from value_a. 



Comments The hexadecimal values may be up to four digits 
long. 

The Hex command displays two four-digit 
values: 

— the first is the result of adding value_b to 
value_a 

— the second is the result of subtracting value_b 
from value_a 



Example 1 Enter H 1 9F, 1 OA <CR>. 

2 DEBUG displays 

02A9 0095 

3 Enter HFFFF,2 <CR>. 

4 DEBUG displays 

0001 FFFD 
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I (INPUT) 



Syntax 



Inputs and displays (in hexadecimal) one byte 
from the specified port. 

I value 



value 



the address of the port that the byte is to be 
input from. 



Comments The port address can be up to 16 bits. 



Example 1 Enter I2F8. 



2 the byte at the addressed port is input and 
displayed. 
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L (LOAD) 



Syntax 
address 



Loads a file or absolute disk blocks into memory. 

L [address[,drive,block,count]] 



the address in memory at which the file or range 
of blocks is to be loaded. If only an offset is 
entered, then the segment indicated by the CS 
register is assumed. 



drive 



the drive from which disk blocks are to be 
loaded. For drive A you must enter 0, for drive B 
you must enter 1, etc. 



block 



the first of a range of blocks to be loaded from 
the disk specified by the drive parameter. 



count 



the number of blocks to be loaded. 



Comments • If all parameters are specified, then DEBUG 
loads blocks of information from disk into 
memory. 

• If you enter L without parameters, or with just 
the address parameter, the file whose file control 
block is correctly formatted at location CS:5C is 
loaded into memory. The file control block at 
CS:5C is set either to the filespec specified when 
the DEBUG command was invoked, or to the 
filespec specified by the most recent "Name" 
command. 

• The default location for programs to load is at 
CS:100. If you specify L and the address 
parameter, the file is loaded at the specified 
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address unless it is a .EXE or .HEX file. In any 
case DEBUG sets the BX:CX registers to the 
number of bytes loaded. 

• If the file has an EXE extension, then it is relo- 
cated to the load address specified in the header 
of the .EXE file. That is, the address parameter 
to the Load command is ignored. The header 
itself is stripped off the .EXE file before the file 
is loaded into memory. Thus the size of the .EXE 
file on disk will differ from its size in memory. 

• If the file is a .HEX file, entering the Load com- 
mand with no parameters causes the file to be 
loaded starting at the address specified within 
the .HEX file. If the address parameter, 
however, is specified, then loading starts at the 
address which is the sum of the address 
specified and the address in the .HEX file. 



Examples The following examples assume the system to be 
initially in MS-DOS. 

1 Enter debug <CR> 

Nb:file.com <CR> 
L <CR>. 

Debug is entered and the subsequent Name 
command sets the file control block at CS:5C to 
identify file "file.com" on the diskette inserted in 
drive B. The Load command then loads this file 
into memory starting at CSilOO (the default 
address). 

2 Enter debug b:file.com <CR> 

L300 <CR>. 

file.com is loaded into memory at location 
CS:100 by the DEBUG command. It is then 
relocated to CS:300 by the Load command. 
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M (MOVE) 



Moves the contents of a specified range of 
memory addresses to the locations starting at a 
specified address. 



Syntax 



M range,address 



range 



The area of memory whose contents are to be 
moved. If you only enter an offset, the segment 
indicated in the DS register is assumed. 



address The start of the destination area. If you only 

enter an offset, then the segment indicated by 
the DS register is assumed. 



Comments If the source and destination areas overlap, the 
move is performed without loss of data. 

The contents of the source area are not changed 
by the move, unless the destination area over- 
laps it. 

If you specify an address as the end of the 
range, you must only enter the offset. The seg- 
ment specified, or defaulted to, in the start 
address of the range is assumed. 



Example 1 Enter MCS: 1 00, 11 0,CS:500 <CR> or 

MCS: 1 OOL 1 1 ,CS:500 <CR>. 

2 The 17 bytes starting at location CS:100 are 
copied to the 17 bytes starting at location 
CS:500. 
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N (NAME) 



Provides file names for the Load and Write 
commands or file name parameters for the pro- 
gram to be debugged. 

Syntax N filespec[,filespec...] 

filespec the file specifier of a file to be loaded into 

memory, written to diskette, or used as a file 
name parameter to the file currently in memory. 

Comments The Name command can be used to provide: 

the name of the disk file to be loaded into 
memory by a subsequent Load command 

the name to be assigned to the file currently in 
memory when the file is subsequently written to 
disk 

file name parameters to the file in memory to be 
debugged. 

The first case enables you to specify the file you 
wish to debug after entering the DEBUG envi- 
ronment. That is, you can enter DEBUG without 
specifying parameters, then use the Name com- 
mand to name the disk file you wish to debug, 
then load the file into memory using the Load 
command. This has the same effect as entering 
the file name as the first parameter to the 
DEBUG command upon invocation. In either 
case the file control block for the file to be 
debugged is set up at location CS:5C and the file 
is loaded. 
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In the second case, the file is already in memory 
and the Name command sets up the file control 
block for the specified file name at location 
CS:5C. When a Write command is subsequently 
entered the file in memory is written to disk with 
the file name whose file control block is set up at 
location CS:5C. 

In the third case, the Name command provides 
file name parameters for the program currently 
in memory. Whatever file control block was set 
at CS:5C is replaced by that of the first such 
parameter. If a second file parameter is speci- 
fied, its file control block is set up at location 
CS:6C. Only two file control blocks are set up, 
although additional file name parameters may 
be included if required. A|l the specified — 
including any delimiters and switches that may 
have been typed — are placed in a save area at 
CS:81, with CS:80 containing a character count. 
Parameters specified in this way are analogous 
to file names specified in the argument list to the 
DEBUG command. 



Examples 1 Enter DEBUG <CR> 

Nb:file.com <CR> 
L <CR>. 

The system enters the DEBUG environment and 
FILE.COM resident on drive B has its file con- 
trol block set up at location CS:5C. The Load 
command subsequently loads this file into 
memory. 

This sequence has the same effect as entering 
"DEBUG b:file.com" 
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2 Enter Nbmewfile.com <CR> 

W<CR> 

The file control block is set up at location CS:5C 
for the file specifier "b:newfile.com". The subse- 
quent Write command writes the file currently in 
memory to drive B and names the file 
"newfile.com". 

3 Enter DEBUG b:f ilel.com <CR> 

Nfile2.dat,file3.dat <CR> 
G<CR> 

The DEBUG command loads the file named 
"filel. com" fi:om drive B to be debugged. The 
Name command sets up two file control blocks 
at locations CS:5C and CS:6C for the file specifi- 
ers b:file2.dat and b:file3.dat, respectively. These 
files then become parameters to filel.COM when 
the subsequent GO command executes filel- 
.COM. Therefore, the file is executed as if the fol- 
lowing command line had been typed: 

b:filel file2.dat file3.dat 
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O (OUTPUT) 



Sends a specified byte to an output port. 
Syntax value.byte 



value the address of the output port. It must be speci- 

fied in hexadecimal and can be up to 16 bits. 



byte a two-digit hexadecimal value to be sent to the 

specified port. 



Example 1 1 E, 27 <CR> 

2 the byte value 27H is output to the port lEH. 
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Q (QUIT) 

Terminates the DEBUG program. 
Syntax Q 

Comments The Quit command terminates the debugger 

without saving the file you are working on. Con- 
trol is returned to MS-DOS command mode. 
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R (REGISTER) 



Displays the contents of the registers and flag 
settings, or displays the contents of a specified 
register with the option to change that value, or 
displays the flag settings with the option of 
reversing any number of those settings. 



Syntax 



R [register-name pipe: F] 



register- any valid register name whose contents are to be 

name examined and optionally changed. This may be 

one of: 

AX DX SI ES IP 
BX SP DI SS PC 
CX BP DS CS 

Note: IP and PC both refer to the Instruction 
Pointer. 



F 



the flag settings are to be displayed and option- 
ally changed. 



Comments If you enter R without parameters, then the con- 
tents of all registers are displayed along with the 
flag settings and the next instruction to be exe- 
cuted. For Example: 

AX=058D BX=0000 CS=0000 DX=0000 
SP=FFFO BP=0000 SI=0000 DI=0000 DS=058D 
ES=058D CS=058D IP=013B 
NV UP EI PL NZ NA PO NC 
058D:013B 83D8 MOV DS,AX 

If you enter R with a register name, then 
DEBUG displays the contents of that register. 
The command then waits for you to do one of 
the following: 
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— press <CR> to terminate the Register 
command without changing the value of the 
displayed register. 

— change the value of the register by entering 
the four-digit hexadecimal value, then 
terminate the Register command by entering 
<CR>. 

The valid flag values are shown in the following 
table: 



Flag Name 


Set 


Clear 


Overflow 


OV (yes) 


NV (no) 


Direction 


DN (decrement) 


UP (increment) 


Interrupt 


EI (enabled) 


DI (disabled) 


Sign 


NG (negative) 


PL (plus) 


Zero 


ZR (yes) 


NZ (no) 


Auxiliary 


AC (yes) 


NA (no) 


Carry 






Parity 


PE (even) 


PO (odd) 


Carry 


CY (yes) 


NC (no) 



If you enter RF, then the current flag settings 
are displayed. You can then either 

— press <CR> to terminate the Register 

command without changing the flag values, 
or 



— change the setting of one or more flags by 
entering the alternate value of the 
appropriate flags. The new values may be 
entered in any order, with or without 
delimiters. 



3-35 



DEBUG 



Example 1 Enter R <CR>. 



DEBUG displays the contents of all registers, 
flag settings and the next instruction to be exe- 
cuted. 



3 Enter RIP <CR>. 

4 DEBUG displays the contents of the Instruction 
Pointer. For example: 

IP 0139 

5 Enter 0138 <CR>. 

6 the contents of the Instruction Pointer are 
changed to 0138. 

7 Enter RF <CR>. 

8 DEBUG displays the flag settings. For example: 

NV UP EI PL NZ NA PO NC - 

9 Enter PE ZR DI NG<CR>. 

1 The Parity flag is set to even (PE), the Zero flag 
is set (ZR), the Interrupt flag is cleared (DI), and 
the Sign flag is set (NG). 

11 Enter RF<CR>. 

12 DEBUG displays the new state of the flags 

NV UP DI NG ZR NA PE NC- 
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S (SEARCH) 



Searches a specified range for a list of bytes. 



Syntax 



S range.list 



range 



the range of addresses within which the search 
is to be made. If you only enter the offset, the 
segment indicated by the DS register is 
assumed. 



list 



the list of one or more bytes to be searched for. 
Bytes in the list must be separated by a space or 
a comma. 



Comments For each occurrence of the list of bytes within 

the specified range, DEBUG returns the address 
of the first byte. If no address is returned, no 
match was found. 



Example 1 



Enter S 1 OOL 1 00,20 <CR> or 
S100,1FF,20 <CR>. 



DEBUG displays the address of every occur- 
rence of byte value 20 in the address range 100 
to IFF, inclusive, for example: 



058D: 
058D: 
058D: 
058D: 
058D: 
058D: 
058D: 



OlOC 
QUO 
0115 
0118 
0120 
0128 
OICE 
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T (TRACE) 



Executes one or more instructions and displays 
the register contents, flag settings and the next 
instruction to be executed. 



Syntax 



T [=address][,value] 



= address DEBUG is to commence execution at this 
address. 



value 



the number of instructions to be executed. 



Comments If the =address parameter is not specified, execu- 
tion begins at CS:IP. 



If the value parameter is not specified, only one 
instruction is executed. 



The display generated is of the same format as 
that of the Register command (without 
parameters). 



Example 1 Enter T = 200,5 <CR>. 

2 Five instructions, starting with the one at loca- 
tion CS:200, are executed, and the register and 
flag values following each instruction are 
displayed along with the next instruction to be 
executed. 



3 Enter T <CR>. 

4 The instruction pointed to by CS:IP is executed 
and the register and flag contents are displayed 
along with the next instruction to be executed. 
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U (UNASSEMBLE) 



Disassembles strings of bytes in memory and 
displays them as assembler-like statements 
along with their corresponding addresses. 

Syntax U [range] 

or 

U [address] 



range the range of addresses whose byte values are to 

be disassembled. If you do not specify the seg- 
ment, then the segment indicated by the CS reg- 
ister is assumed. 



address the start of a 32 byte area of memory to be dis- 

assembled. If you only enter an offset, then the 
segment indicated by the CS register is 
assumed. 



Comments • If neither the range nor address parameter is 
specified, then 32 bytes are disassembled start- 
ing at location CS:IP. If the Unassemble 
command is given more than once, each 
subsequent invocation starts at the address 
following the last disassembled location. 

• The number of bytes disassembled may be 
slightly more than the number you specified. 
This is because instructions are not always the 
same length and the final address in a range 
will not always contain the last byte of an 
instruction. 

• The first address of a range, or the address 
parameter, must always refer to the first byte of 
an 8086 instruction, otherwise results are 
unpredictable. 
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Example 1 Enter U058D:204L8 <CR>. 

2 Eight bytes starting at location 058D:204 are 
disassembled and the result displayed: 

058D:0204 8D16DFOD LEA DX,[ODDF] 

058D:0208 42 INC DX 

058D:0209 03DO ADD DX,AX 

058D:020B 8916E50B MOV [0BE5],DX 



3-40 



DEBUG 



W (WRITE) 



Syntax 
address 



Writes the file being debugged to disk. 
W [address[,drive,block,count] 



the start address of the code in memory that is 
to be written to disk. If you enter only an offset, 
then the segment indicated in the CS register is 
assumed. 



drive 



the drive containing the specified blocks to 
which code in memory is to be written. For drive 
A you must enter 0, for drive B you must enter 1, 
etc. 



block 



the block number on disk that is the first of a 
contiguous range of blocks to be overwritten 
with code from memory. 



count 



the number of disk blocks to be overwritten with 
code from memory. 



Comments • If you enter the WRITE command without 

parameters, then the file is written to disk start- 
ing from memory address CS:100. If you specify 
the address parameter, then the file in memory, 
starting from the specified address, is written to 
disk. 

• In either case, before executing the WRITE 
command, BX:CX must be set to the number of 
bytes to be written if the count parameter is not 
included. This value was set up correctly when 
the file was loaded (either by the Load command 
or the DEBUG command itself). However, if, 
since loading the file, you have executed a GO or 
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TRACE command, then the value of BX:CX will 
have been changed. Be sure this value is set up 
correctly. 

• When the WRITE command writes a file to disk, 
it obtains the drive specifier and file name via 
the file control block set up at CS:5C. If no drive 
specifier is set up, then the default is assumed. 
This file control block is set up either by the 
DEBUG command (for the file you specify as a 
parameter to DEBUG) or by a subsequent 
NAME command. If it does not indicate the file 
specifier you require, you must set up this file 
control block using the NAME command. Refer 
to "Memory Maps, Control Blocks, and Diskette 
Allocation" for further details. 

• When the file is written to disk it overwrites the 
version currently on disk unless the specified file 
name does not exist, in which case a new file is 
created. 

• If all parameters are specified, then the code in 
memory is written to the drive specified by the 
parameter. The data to be written starts at the 
memory location specified by the address 
parameter, and is written to the blocks on the 
disk specified by the block and count parame- 
ters. Be extremely careful to correctly specify the 
blocks, since information stored there previously 
will be destroyed by this operation. 



Examples 1 Enter W <CR>. 

The file in memory, starting from location 
CS:100, is written to disk with the file specifier 
defined by the file control block set up at 
location CS:5C. The number of bytes written is 
given by BX:CX. 
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2 Enter W200<CR>. 

The file in memory, starting from location 
CS:200, is written to disk with the file specifier 
defined by the file control block set up at loca- 
tion CS:5C. The number of bytes written is given 
byBX:CX. 

3 Enter W200, 1 , 1 F,20 <CR>. 

Blocks IF through 3F on drive B are overwritten 
with the data starting at memory location 
CS:200. 



3-43 



DEBUG 



DEBUG ERROR MESSAGES 



BF Bad Flag 

You attempted to alter a flag, but entered some 
characters that are not acceptable pairs of flag 
values. See R (Register) command for the list of 
acceptable flag entries. 



BP Too many Breakpoints 

You specified more than ten breakpoints as 
parameters to the GO command. Reenter the 
command with ten or fewer breakpoints. 



BR Bad Register 

You entered the R command with an invalid reg- 
ister name. 



DF Double Flag 

You entered two values for one flag. 
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Overview 



The 8086 microprocessor has an extremely flexible 
addressing scheme. The 8086 uses a 16-bit word, but 
can address a megabyte of memory. The 8086 sup- 
ports seven different addressing modes. 

To take advantage of the flexibility of the 8086, so 
that you can write assembly language code and navi- 
gate through programs while debugging, study the 
addressing scheme by carefully reading this chapter. 
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The 20-Bit Address 



The AT&T Personal Computer 6300 utilizes the 
full address space that is available due to the 
design of the 8086 microprocessor. The 
addresses are 20 bits long, so the address space 
is two to the twentieth power, 1024K, or one 
megabyte. 

The 8086 has a 16-bit word. To convert 16-bit 
words to a 20-bit address, the 8086 uses "seg- 
mented addressing." A 20-bit address is created 
by using values from two separate registers. 
Two 16-bit numbers are used. 

The binary representation of the first number is 
considered to have four binary zeroes tacked on 
to its end. This effectively multiplies the number 
by 16. This value is known as the segment por- 
tion of the address. The segment portion can 
point to any 16-byte segment of memory in the 
megabyte address space. However, with four 
zeroes as its least significant bits, it cannot 
"zero in" on individual bytes. The segment reg- 
ister's function is just to point to a 16-byte bound- 
ary (also known as a paragraph boundary). 

Once a segment is located, the other register 
comes into play. This "offset register" points to 
the relative part of the address. The 16 bits that 
comprise the offset register point to an individ- 
ual byte which is relative to the start of the 
segment. 
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The 8086 locates a particular address by: 

Shifting the segment register to the left by four 
bits 

Adding the contents of the offset register 

The 20-bit address is conventionally expressed 
in special notation: 

<segment register>r<of fset register> 

009F:0012 

Segment address 009F0 
+ Relative address 0012 

= Actual Address 00A02 
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Aligned and 
Non- Aligned Words 



The instructions for the 8086 are made up of 
from one to six bytes. Instructions can start at 
either an even or odd address. The 8086 is capa- 
ble of accessing two bytes of data in memory in 
a single memory cycle. When the CPU accesses 
a word (16 bits) located at an even address, it is 
accessing an "aligned" word. The word is 
aligned because both bytes are located at the 
same word address and can be accessed in a 
single memory cycle. 

When the CPU accesses a word starting at an 
odd address, it is accessing a "non-aligned" 
word. Since the two bytes comprising the word 
do not occupy the same word address, two 
memory cycles are required to read the entire 
word. 

The importance of aligned or non-aligned words 
is determined by the importance of execution 
speed in your application. It is good program- 
ming practice to store data starting at an even 
address. If your program accesses or manipu- 
lates many word quantities, this will help speed 
program execution. If you are writing a device 
driver and instruction cycle times affect the 
execution of your program, the impact of aligned 
and non-aligned words should be taken into 
consideration. 
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Registers and Flags 



General There are two main groups of general registers 

Registers used by the 8086: the data group and the pointer 
and index group. Each register is 16 bits wide. 

• The data registers are AX, BX, CX, and DX. 
Each can be used as a single 16-bit register or as 
two 8-bit registers. When they are used as two 
8-bit registers, they are divided into an upper(H) 
and lower(L) half and called AH, AL, BH, BL, 
CH, CL, DH, and DL. 

• The pointer and index registers are 16-bit regis- 
ters. They are named according to their func- 
tions: SP (stack pointer), BP (base pointer), SI 
(source index), and DI (destination index); 
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Segment There are four segment registers in the 8086. 

Registers Each register is 16 bits and their names reflect 
their use: 



• CS — Code Segment 

Always defines the current code segment. 

• DS — Data Segment 

Usually defines the current data segment. 

• SS — Stack Segment 

Always defines the current stack segment. 

• ES — Extra Segment 

Can define an auxiliary data segment. 



These registers are used in combination with 
other registers to form the 20-bit address. Each 
segment begins on a paragraph (16 byte) bound- 
ary. There are four "current" segments at any 
one time. The contents of each segment register 
is called the "segment base value". The sections 
on "Code, Data, and Stack Segments" and 
"Addressing Modes" give details on how these 
registers are utilized. 



Instruction The instruction pointer (IP) is used in conjunc- 
Pointer tion with the Code Segment register to point to 

the address of the next executable instruction. 

The IP is also a 16-bit register. 



Flags The 8086 has nine 1-bit status or condition flags 

that are used to indicate the condition of the 
result of an arithmetic or logical operation that 
has just occurred. Some of the assembly lan- 
guage instructions use these flags to condition- 
ally change the execution path of a program. 
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Flag AF Auxiliary Carry Flag 

Definitions This flag is set (i.e., equal to 1) under two 

conditions: 



During addition there is a carry of the low 
nybble to the high nybble. (nybble = 4 bits) 

During subtraction there is a borrow from 
the low nybble to the high. 

CF Carry Flag 

This flag is set when there has been a carry 
or a borrow to the high-order bit of the (8- or 
16-bit) result of an operation. 

OF Overflow Flag 

When this flag is set, an arithmetic over- 
flow has occurred and a significant digit 
has been lost. 

SF Sign Flag 

This flag is set when the high-order bit of 
the result of an operation is a logical 1. 
Since negative binary numbers are 
represented using two's complement 
notation, SF reflects the sign of the result: 
indicates a positive number and 1 indicates 
a negative number. 

PF Parity Flag 

If this flag is set, the result of the operation 
has an even number of ones in it. Use this 
flag to check for data transmission errors. 

ZF Zero Flag 

This flag is set when the result of an opera- 
tion is zero. 
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Flag TF Trap Flag 

Definitions When set, the trap flag puts the system into 

(Cont'd) single-step mode for the purposes of debug- 

ging. An internal interrupt is generated 
after each instruction so that you can 
inspect your program one instruction at a 
time. 



IF Interrupt-enable Flag 

If this flag is set, external (maskable) inter- 
rupts are recognized by the 8086. 



DF Direction Flag 

This flag is set and cleared by the STD (Set 
Direction Flag) and CLD (Clear Direction 
Flag) instructions. If it has the value 1, SI 
and DI are decremented during string move 
operations. If it has the value of 0, SI and 
DI are incremented during string move 
operations. This flag is used for the follow- 
ing instructions: MOVS, MOVSB, 
MOVSW, CMPS, CMPSB, and CMPSW. 



The flag register looks like this: 



Bit 15 14 13 12 11 10 9 



76543210 



— — OF DF IF TF 
FLAGSh 



SF ZF - AF - PF - CF 
FLAGSl 
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CPU 
Registers 



AX 


AH 


AL 


accumulator 


BX 


BH 


BL 


base 


CX 


CH 


CL 


count 


DX 


DH 


DL 


data 



SP 



BP 



SI 



DI 



IP 


FLGSh 


FLGSl 



cs 



DS 



ES 



SS 



stack pointer 
base pointer 
source index 
destination index 

instruction pointer 
flags 

code segment 
data seg 
extra seg 
stack seg 
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Code, Data, and 
Stack Segments 



When you invoke a program, MS-DOS loads all 
of its segments into memory on paragraph 
boundaries. The segment registers are set to 
point to these locations. The data, code, and 
stack segments aren't necessarily far apart in 
memory; they may, in fact, overlap. Each seg- 
ment may be up to 64 KB in length. 



Code Programs are limited to 64K of code, unless they 

Segment change the value in the CS register. If a pro- 

gram changes the CS register, it may address up 
to 1024K of code. 

The CS register is modified by the FAR CALL 
and FAR RETum instructions. Use these 
instructions to execute code that is located out- 
side the bounds of the current segment. 



Data Most programs use a maximum of 64 KB of 

Segment memory for data. This includes Pascal and 

compiled BASIC. Assembly language programs, 
however, can use additional memory for data by 
employing the Extra Segment. 



Extra The extra segment may be used in any manner 

Segment you wish but is often used for transferring large 

blocks of data quickly in memory or as a storage 

area for a second stack. 



Stack 
Segment 

• Interrupts 

• Inter-segment calls 

• One program calls another 

441 



Stacks are used for temporarily storing register 
contents and other important values under these 
conditions: 
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General The flexible architecture of the 8086 supports 

Comments many different memory-addressing modes. 

These can be broken down into six main types of 
addressing: immediate, register, direct, register 
indirect, and two kinds of calculated addressing. 
The following section discusses these modes and 
concerns the nature of the operand. 



Immediate In the immediate addressing mode, the operand 
Addressing appears in the instruction. For example, 

MOV AX, 333 

moves the constant value 333 into the AX 
register. 



Register The register addressing mode uses the contents 

Addressing of one of the registers as the operand for the 
instruction. The instruction can specify that 
either 8 bits or 16 bits are to be manipulated. For 
example: 

MOV AX,BX ;moves 16 bits from BX to AX 
MOV AL,BL ;moves 8 bits from BL to AL 
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Direct The direct addressing mode specifies a location 

Addressing in memory whose contents are used as the ope- 
rand for the instruction. Example: 

MOV CX,COUNT 

This instruction uses the value found in the 
memory location designated by the symbol 
COUNT. Unless otherwise specified, COUNT is 
expected to be somewhere in the Data Segment. 
To specify that the operand is located in a seg- 
ment other than the data segment, use the 
"segment override prefix:" 

MOV CX,ES:COUNT 

This syntax specifies that COUNT is located in 
the Extra Segment. 



Register With the register indirect addressing mode, the 

Indirect 16-bit offset address is contained in a base or 

Addressing index register. That is, the offset address resides 
in the BX, BP, SI, or DI register. Example: 

MOV AX, [SI] 

The 16-bit offset contained in the SI register is 
combined with the data segment register to 
compute the 20-bit address of the operand to 
move into register AX. Which segment register 
is used to compute the address depends on which 
instruction you are using (i.e., data segment or 
segment override for MOV, code segment for 
JMP or CALL, etc.). 
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Calculated The calculated addressing modes are like a corn- 
Addressing bination of register indirect mode and direct 
Modes addressing mode. There are two calculated 

addressing modes: single index and double 
index. In single index addressing, a 16-bit offset 
from the BX, BP, SI or DI register is added to an 
offset location in memory specified in the in- 
struction. The combined value of these two items 
provides the offset into memory from which the 
operand is fetched. If the BP register is used the 
offset is from within the stack segment; other- 
wise the offset is from within the data segment. 
As always, use of a segment override prefix can 
change this. Examples: 

MOV AX, COUNT[DI] 
MOV AX, RECORD[BP] 

In double index calculated addressing mode, 
values from two 16-bit registers are added to an 
optionally specified location in memory to pro- 
duce the final offset. Either the BX or BP regis- 
ter is used for one of the register values, and the 
SI or DI register is used for the other one. If only 
two registers are given with no memory location, 
the memory location defaults to 0000 (start of 
segment). Once again, the default calculation is 
from the stack segment if the BP register is 
used; if BX is used the default is from the data 
segment. Examples: 

MOV AX, COUNT[BX+SI] 
MOV AX, RECORD[BP] [DI] 
MOV AX, [BX] [DI] 
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• Overview 

• The Address Space 

• Low Memory Map 

• ROM BIOS Data Area 

• File Control Blocks 

• ASCIIZ Strings 

• Handles 

• Diskette Layout 

• Diskette Directory 

• File Allocation Table 

• Diskette Formats 
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Overview 



The purpose of this chapter is to enable you to 
locate items in memory or on diskette for the 
purposes of programming and debugging. 

The first portion of the chapter contains detailed 
memory maps of the RAM and ROM memory 
areas. The sections on control blocks deal with 
program file formats and I/O data structures. 
The last part of this chapter describes how data 
is organized on the diskette. 
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The Address Space 



Hex 


Decimal 


Contents 


00000 


OK 


Interrupt vectors (see detail in low memory 
map) 


04000 


16K 


DOS software 


08000 


32K 


Language, applications programs and 
data 

Note: There is at least 98,000 hex or 608K 
of address space reserved for user pro- 
grams and data. To take advantage of the 
full amount, you must have purchased and 
installed the physical memory. 


• 
• 
• 


AOOOO 


640K 


Reserved for extended graphics 


BOOOO 


704K 


Monochrome display buffer — Not used 


B8000 


736K 


Color/graphics display buffer(s) 


C8000 


800K 


Fixed disk adapter's ROM (Optional) 


FOOOO 


960K 


Reserved for ROM expansion 


FCOOO 


1008K 


ROM BIOS 
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Low Memory Map 



Hexadecimal addresses are in segment:offset format. 



Hex Decimal Contents 

0:0000 Interrupt vectors - 7 

8259 interrupt controller vectors (8-F) 



BIOS interrupt vectors 10-lF 
MS-DOS interrupt vectors 20-3F 
Assignable interrupt vectors (40-FF) 

Note: These vectors may be assigned to 
non-Intel hardware and software 
products. 

ROM BIOS data area (also called BIOS 
communications area) See map on next 
page. 

DOS data area (also called DOS com- 
munications area) 



0:0040 64 

0:0080 128 

0:0100 256 

0:0400 1024 

0:0500 1280 

0:0600 1536 
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ROM BIOS Data Area 



Hex addresses are in segment:offset format. 



Hex 


Decimal 


Contents 


0:0400 


1024 


Hardware environment parameters 
(printer and RS232C device addresses, 


0:0417 


1047 


memory size, etc.) 


0:043E 


1086 


Keyboard buffer and status bytes 


0:0449 


1097 


Floppy and hard disk status bytes 

Video display area (current mode, color 
pallette, cursor position, active page 


0:0467 


1127 


numbers, etc.) 

Data area for option ROM and 8253 


0:0471 


1137 


timer chip 

Fixed disk, I/O timeouts, and more key- 


0:0488 


1160 


board status information 


0:0500 


1280 


RESERVED 

Inter-applications communications area 
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FCB The standard File Control Block (FCB) contains 

Format 37 bytes of file control information. The extend- 

ed File Control Block is used to create or search 
for files in the disk directory that have special 
attributes. If the extended FCB is used, it adds a 
7-byte prefix to the standard FCB. 

Any of the DOS functions which employ FCBs 
may use either an FCB or an extended FCB. 
(See chapter 7 for a description of each DOS 
function call.) 

If you are using an extended FCB, set the appro- 
priate register to the first byte of the prefix, not 
to the first byte of the standard FCB, before exe- 
cuting the function call. 
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FFH 


Zeros 


attri- 
bute 


Drive 


Filename (first 7 bytes) or Reserved 
Device Name 


File- 
name 
(1 byte) 


Filename 
extension 


Current 
block 


Record 
size 


(*) 

File size 
(low part) 


(*) 

File size 
(high part) 


(*) 

Date of 
last write 


(*) 

Time of 
last write 


(*) 

Reserved for system use 


Current 
record 


Random record 
no. (low part) 


Random record 
no. (high part) 





(1) FCB extension 

(2) Standard FCB 



(*) Areas with an asterisk are filled by DOS and must not be modified. 
Other areas must be filled by the using program. 
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Offsets are in decimal. 



Byte Function 

Drive number 

Before open: — default drive 

1 — drive A 

2 — drive B etc. 

After open: 1 — drive A 

2 — drive B etc. 

A is replaced by the actual drive 
number when the file is opened. 

1-8 Filename, left-justified, padded with 
trailing blanks. If a reserved device 
name is placed here (e.g., LPTl,) do not 
include the optional colon. 

9- OB Filename extension, left-justified, with 

trailing blanks (may be all blanks). 

OC-OD Current block number relative to the 
beginning of the file (starting at zero). 
A block is defined as a group of 128 
records. This field is set to when the 
file is opened. This field and the Cur- 
rent Record field (offset 20H) make up 
the record pointer that is used for 
sequential reads and writes. 

OE-OF Logical record size in bytes. Automati- 
cally set to 80H during open. If this is 
not correct, set it to the correct value. 

10- 13 File size in bytes. The first word of the 

field is the low-order part of the size. 
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Byte Function 

14-15 Date the file was created or last up- 
dated. The bits correspond to the date 
as follows: 

< 15 >< 14 > 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 
y y y y y y y mmmmd d d d d 

yy = 0-119 (1980 to 2099) 
mm = 1-12 
dd = 1 - 31 

16-17 Time the file was created or last up- 
dated. The bits correspond to the time 
as follows: 

< 17 >< 16 > 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 
h h h h h mmmmmms s s s s 

hh = - 23 
mm = 0-59 

ss = - 30 (number of 2-second 
increments) 

18-lF Reserved for use by DOS. 

20 Current relative record number (0-127) 
within the current block. Set this field 
before doing sequential read/ write 
operations; it is not initialized by the 
Open File function call. 

21-24 Relative record number; relative to the 
beginning of the file, starting with zero. 
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Byte Function 

This field is not initialized by the Open 
File function call and must be set before 
doing a random read or write. If the 
record size is less than 64 bytes, both 
words of the field are used; otherwise, 
only the first three bytes are used. 

Note: If you use the FCB at offset 5CH 
of the Program Segment Prefix, the last 
byte of the Relative Record field is the 
first byte of the unformatted parameter 
area that starts at offset 80H. This is 
the default Disk Transfer Address. 



Extended 

Control 

Block 



Byte Function 

FGB-7 Contains hex FF to indicate this 
is extended FCB. 



FCB-6 to 
FCB-2 



Reserved 



FCB-1 Attribute byte. 02 = Hidden file 

04 = System file 
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ASCIIZ Strings 



MS-DOS version 2.11 provides a set of new func- 
tion calls for file I/O that are easier to use than 
the "traditional" calls that were used in past 
versions. These new calls do not utilize file con- 
trol blocks. To open a diskette file, you simply 
provide information to identify the file in the 
form of an ASCIIZ string. DOS returns a 
numeric value, a "handle", that you use to refer 
to the file once you have opened it. 

The older function calls that require the use of 
file control blocks and do not utilize ASCIIZ 
strings and handles are supported in MS-DOS 
2.11 to provide upward compatibility. Use the 
newer function calls whenever possible. See 
Chapter 7 for details of function calls. 



ASCIIZ An ASCIIZ string, also known as a pathname 

String string, has the following format: an optional 

Format drive specifier, followed by a directory path, and 

where applicable, a filename. The last byte must 

be binary zeroes. For example: 

A:\LEVELA\LEVELB\FILEA 

(followed by a byte of zeroes) 

Either back slash (\) or forward slash (/) are 
valid path-separator characters. 
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Handles 



Several of the new function calls that support 
files or devices use an identifier known as a 
"handle" (also known as a "token"). When you 
create or open a file or device with these function 
calls, a 16-bit value is returned in register AX. 
Use this handle to refer to the file after it has 
been opened. 

The following handles are pre-defined by DOS 
for your use. You need not open them before 
using them: 

0000 Standard input device 

0001 Standard output device 

0002 Standard error output device 

0003 Standard auxiliary device 

0004 Standard printer device 

Note: 

See your MS-DOS User's Guide for information 
on redirecting I/O for the first two handles. 



5-12 



Memory Maps 
Control Blocks 
Diskette Allocation 

Diskette Layout 



The DOS area of the diskette is formatted as 
follows: 



Reserved Area — variable size 


First copy of file allocation table — 


variable size 


Second copy of file allocation table 


— variable 


size 




Root directory — variable size 


File data area 



Clusters Space for a file in the data area is not preallo- 

cated. The space is allocated one "cluster" at a 
time. A cluster consists of one or more consecu- 
tive sectors; all of the clusters for a file are 
"chained" together in the File Allocation Table 
(FAT). On diskettes formatted by MS-DOS 2.11, 
there are two copies of the FAT kept, for consis- 
tency. Should the disk develop a bad sector in 
the middle of the first FAT, the second is used 
as a backup. 
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Diskette Directory 



The FORMAT command builds the root direc- 
tory for all disks. Its location on disk and the 
maximum number of entries are dependent on 
the media. 

Since directories other than the root directory 
are regarded as files by MS-DOS, there is no 
limit to the number of files they may contain. 

All directory entries are 32 bytes in length, and 
are in the following format (byte offsets are in 
hexadecimal): 

Directory 0-7 Filename. Eight characters, left aligned 
Format and padded, if necessary, with blanks. If 

this is not currently a file directory entry, 
the first byte of this field indicates the 
status as follows: 

OOH The directory entry has never been 
used. This is used to mark the end of 
the allocated directory and limit the 
length of directory searches, for per- 
formance reasons. 

2EH The entry is for a directory (2EH is 
the ASCII code for the dot char- 
acter used to represent a directory). If 
the second byte is also 2EH (i.e., the 
entry is '..'), then the cluster field con- 
tains the cluster number of this direc- 
tory's parent directory (OOOOH if the 
parent directory is the root directory). 
Otherwise, bytes 01 H through OAH 
are all spaces (i.e., the entry is '.') and 
the cluster field contains the cluster 
number of this directory. 

E5H The file was used, but it has been 
erased. 

Any other character is the first character of 
a filename. 
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Directory 8-OA Filename extension. 
Format 

(cont'd) OB File attribute. The attribute byte is 

mapped as follows (values are in hex): 

01 File is marked read-only. An 
attempt to open the file for writing 
using the Open a File system call 
(Function Request SDH) results in 
an error code being returned. This 
value can be used along with other 
values below. Attempts to delete the 
file with the Delete File system call 
(13H) or Delete a Directory Entry 
(41H) will also fail. 

02 Hidden file. The file is excluded 
from normal directory searches. 

04 System file. The file is excluded 
from normal directory searches. 

08 The entry contains the volume label 
in the first 11 bytes. The entry con- 
tains no other usable information 
(except date and time of creation), 
and may exist only in the root 
directory. 

10 The entry defines a sub-directory, 
and is excluded from normal direc- 
tory searches. 

20 Archive bit. The bit is set to "on" 
whenever the file has been written 
to and closed. It is used by 
BACKUP and RESTORE com- 
mands for determining whether or 
not a file has changed since its last 
backup. The BACKUP command 
clears this attribute on all files 
backed up. 
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Directory The system files (lO.SYS and 

Format MSDOS.SYS) are marked as read-only, 

(cont'd) hidden, and system files. Files can be 

marked hidden when they are created. 
Also, the read-only, hidden, system, and 
archive attributes may be changed 
through the Change Attributes system 
call (Function Request 43H). 

OC-15 Reserved. 

16-17 Time the file was created or last updated. 
The hour, minutes, and seconds are 
mapped into two bytes as follows: 



Offset 17H 



1 HI HI HI 


H 1 


HI 


M 1 


M 1 


M 


7 6 5 


4 


3 


2 


1 





Offset 16H 












1 M 1 M 1 M 1 


s 1 


s 1 


s 1 


s 1 


s 


7 6 5 


4 


3 


2 


1 






H is the number of hours (0-23) 
M is the number of minutes (0-59) 
S is the number of two-second 
increments 

The time is stored with the least signifi- 
cant bit first. 
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Directory 

Format 

(cont'd) 



18-19 



Date the file was created or last updated. 
The year, month, and day are mapped 
into two bytes as follows: 



Offset 19H 

|Y|Y|Y|Y|Y|Y|Y|M 
76543210 

Offset 18H 

iM|M|M|D|D|D|D|D 
76543 210 

Y is the number of years since 1980, 

0-119 (1980-2099) 
M is the month number 1-12 
D is the day of the month 1-31 

The date is stored with its least signifi- 
cant byte first. 

lA-lB The cluster number of the first cluster in 
the file. The first cluster for data space 
on all disks is cluster 002. 

The cluster number is stored with the 
least significant byte first. 



Refer to "How to Use the File Allocation Table" 
for details on converting cluster numbers to logi- 
cal sector numbers. 

IC-IF File size in bytes. The first word of this 
four-byte field is the low-order part of the 



Note: 



size. 
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File Allocation Table (FAT) 



The following information is included primarily 
for system programmers who are writing install- 
able device drivers. This section explains how 
MS-DOS uses the File Allocation Table to con- 
vert the clusters of a file to logical sector num- 
bers. The driver program is then responsible for 
locating the logical sector on disk. If you are 
writing a system utility, use the MS-DOS file 
management function calls for accessing files; 
programs that access the FAT directly are not 
guaranteed to be upwardly-compatible with 
future releases of MS-DOS. 



FAT The File Allocation Table is an array of 12-bit 

Entries entries (1.5 bytes) for each cluster on the disk. 

• The first two FAT entries map a portion of the 
directory; these FAT entries indicate the size 
and format of the disk. 

• The second and third bytes currently always 
contain FFH. 

• The third FAT entry, which starts at byte offset 
4, begins the mapping of the data area (cluster 
002). Files in the data area are not always writ- 
ten sequentially on the disk. The data area is 
allocated one cluster at a time, skipping over 
clusters already allocated.The first free cluster 
found will be the next cluster allocated, regard- 
less of its physical location on the disk. This 
permits the most efficient utilization of disk 
space because clusters made available by eras- 
ing files can be allocated for new files. 
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Each FAT entry contains three hexadecimal 
characters: 

• 000 If the cluster is unused and avail- 

able. 

• FF7 The cluster has a bad sector in it. 

MS-DOS will not allocate such a 
cluster. CHKDSK counts the number 
of bad clusters for its report. These 
bad clusters are not part of any allo- 
cation chain. 

• FF8-FFF Indicates the last cluster of a file. 

• XXX The cluster number of the next clus- 

ter in the file. The cluster number of 
the first cluster in the file is kept in 
the file's directory entry. 

The File Allocation Table always begins on the 
first sector after the reserved sectors. If the FAT 
is larger than one sector, the sectors are contigu- 
ous. Two copies of the FAT are usually written 
for data integrity. The FAT is read into one of 
the MS-DOS buffers as needed (open, read, write, 
etc.). For performance reasons, this buffer is 
given a high priority so that it stays in memory 
as long as possible. 
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How to Use 
the File 
Allocation 
Table 



Use the directory entry to find the starting clus- 
ter of the file. Next, to locate each subsequent 
clu ster of the file: 

Multiply the cluster number just used by 1.5 
(each FAT entry is 1.5 bytes long). 

The whole part of the product is an offset into 
the FAT, pointing to the entry that maps the 
cluster just used. That entry contains the cluster 
number of the next cluster of the file. 

Use a MOV instruction to move the word at the 
calculated FAT offset into a register. 

If the last cluster used was an even number, 
keep the low-order 12 bits of the register by 
ANDing it with FFF; otherwise, keep the high- 
order 12 bits by shifting the register right 4 bits 
with a SHR instruction. 



If the resultant 12 bits are FF8H-FFFH, the file 
contains no more clusters. Otherwise, the 12 bits 
contain the cluster number of the next cluster in 
the file. 
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To convert the cluster to a logical sector number 
(relative sector, such as that used by Interrupts 
25H and 26H and by DEBUG): 

1 Subtract 2 from the cluster number. 

2 Multiply the result by the number of sectors per 
cluster. 

3 Add to this result the logical sector number of 
the beginning of the data area. 
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Diskette Formats 



On an MS-DOS disk, the clusters are arranged 
on diskette to minimize head movement for 
multi-sided media. All of the space on a track (or 
cylinder) is allocated before moving on to the 
next track. This is accomplished by using the 
sequential sectors on the lowest-numbered head, 
then all the sectors on the next head, and so on 
until all sectors on all heads of the track are 
used. The next sector to be used will be sector 1 
on head of the next track. 

The first byte of the FAT, called the Media De- 
scriptor Byte, can sometimes be used to deter- 
mine the format of the disk. The following for- 
mats have been defined for the AT&T Personal 
Computer 6300, based on values of the first byte 
of the FAT. 
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MS-DOS 
Standard 
Diskette 
Formats 



No. sides 

Tracks/side 

Bytes/sector 

Sectors/track 

Sectors/cluster 

Reserved 
sectors 

No. FATs 

Root directory 
entries 

No. sectors 

Media 

Descriptor 

Byte 

Sectors for 
1 FAT 



1 
40 
512 
8 
1 

1 
2 



1 
40 
512 
9 
1 

1 
2 



2 
40 
512 



2 
40 
512 
9 
2 

1 
2 



64 64 112 112 
320 360 640 720 

FE FC FF FD 
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Overview 



This chapter describes the MS-DOS program file 
formats and procedures for loading them into 
memory. MS-DOS supports two main program 
file formats: .EXE and .COM. 

The .EXE format is the more flexible program 
type. An .EXE file is limited in size only by the 
amount of user memory installed in your 
system. 

Programs linked by MS-LINK are output in 
.EXE format. .EXE files can be executed either 
by C0MMAND.COM or by an EXEC system 
call (Function Request 4BH) in your program. 

A .COM program file cannot exceed 64K bytes 
in length. However, because it does not have the 
same lengthy header that an .EXE file does, a 
.COM file takes up less diskette storage space 
and loads into memory more quickly than an 
.EXE file. 

After assembling and linking your program, it 
must be converted to .COM format. The easiest 
way to do this is with the EXE2BIN utility pro- 
vided on your MS-DOS Supplemental Programs 
diskette. 
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and Loading 

Pros and Cons for Selecting 
a Program File Format 



This section is concerned with the pros and cons 
of selecting between a .EXE program format and 
the .COM program type. 

PROS for .EXE 

• Can be larger than 64 K 

• Can cross segment boundaries 

• Can run .EXE immediately after linking, i.e., 
you need not take the extra step of running 
EXE2BIN 

• Can declare a stack segment in the assembly 
program 

CONS for .EXE 

• Disk file has large "header" containing reloca- 
tion information, .EXE therefore takes more 
space on disk and takes longer to load into 
memory at execution time. 
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PRO for .COM 

• .COM files are smaller and faster loading 
because .COM does not have a file header 
containing relocation information. 



CONS for .COM 

• .COM files can be no larger than one 64K 
segment. 

• .COM is segment-relocatable; the segment can 
be relocated at run time. However, all of the 
addresses in the program must be relative to the 
same segment address. 
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EXE2BIN 



EXE2BIN EXE2BIN is an executable program available 
on your MS-DOS system diskette. It converts 
programs that are in .EXE format (as they are 
after having been linked) into the .COM format. 

EXE2BIN can generate two types of .COM files: 
relocatable and non-relocatable. 
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Syntax EXE2BIN <input filename> <output file 

name> 

Both file names are in the form: 
[d:][path][filename[.ext]] 



Example EXE2BIN B:PROG.EXE B:PROG.COM 



Discussion In specifying the input file, everything except 
the file name is optional. If you do not specify a 
drive, the default is used. If you do not specify a 
path, the default path is used. If you do not spec- 
ify an extension, the default is .EXE. The input 
file is converted to .COM file format (memory 
image of the program) and placed in the output 
file. 

You are not required to enter any part of the 
output file specification. If you do not specify a 
drive, the drive of the input file will be used. If 
you do not specify an output path or filename, 
the input path or filename will be used. If you do 
not specify a filename extension in the output 
filename, the new file will be given an extension 
of .BIN. 

The input file must be in valid .EXE format pro- 
duced by the linker. The resident, or actual code 
and data part of the file must be less than 64K. 
There must be no STACK segment. 
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Two kinds of conversions are possible, depend- 
ing on the initial CS:IP (Code Segment: Instruc- 
tion Pointer) specified in the .EXE file: 

1 If CS:IP is specified as 0000: lOOH, it is assumed 
that the file is to be run as a .COM file with the 
location pointer set at lOOH by the assembler 
statement ORG; the first lOOH bytes of the file 
are deleted. No segment address fixups (that is, 
instructions that contain a reference to an abso- 
lute segment address) are allowed, as .COM files 
must be segment relocatable. Once the conver- 
sion is complete, rename the resulting file with a 
.COM extension. The command processor can 
load and execute the program in the same way 
as the .COM programs supplied on your MS- 
DOS diskettes. 

2 If CS:IP is not specified in the .EXE file, a pure 
binary conversion is assumed. If segment fixups 
are necessary (i.e., the program contains instruc- 
tions requiring a segment address), you are 
prompted for the fixup value. This value is the 
absolute segment at which the program is to be 
loaded. The resulting program is usable only 
when loaded at the absolute memory address 
specified by your application. The command 
processor is not capable of properly loading the 
program. This is the case when writing a .BIN 
program to use in an application such as a 
device driver that is always loaded at the same 
absolute address. 
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EXE2BIN 
Messages 



Amount read less than size in header 

The program portion of the file was smaller than 
indicated in the file's header. You should reas- 
semble and relink your program. 



File cannot be converted 

CS:IP does not meet either of the criteria speci- 
fied above, or it meets the .COM file criterion but 
has segment fixups. This message is also dis- 
played if the file is not a valid executable file. 



File creation error 

EXE2BIN cannot create the output file. Run 
CHKDSK to determine if the directory is full or 
if some other condition caused the error. 



File not found 

The file is not on the diskette specified. 



Fixups needed - base segment (hex): 

The source (.EXE) file contained information 
indicating that a load segment is required for 
the file. Specify the absolute segment address at 
which the finished module is to be located. 
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InsuMcient disk space 

There is not enough disk space to create a new 
file. 



Insufficient memory 

There is not enough memory to run EXE2BIN. 

WARNING - Read error in EXE file 

Amount read less than size in header. This is a 
warning message only. However, it is usually a 
good idea to reassemble and relink your source 
program when this message appears. 
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File Header Format 



The .EXE files produced by MS-LINK consist of 
two parts: 

• Control and relocation information 

• The load module 

The control and relocation information is at the 
beginning of the file in an area called the 
header. The load module immediately follows 
the header. 

Note: 

.COM files do not have file headers. 
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The header is formatted as follows (offsets are in 
hexadecimal): 

Offset Contents 

00-01 Must contain 4DH, 5AH. 

02-03 Number of bytes contained in last 
page; used for reading overlays. 

04-05 Size of the file in 512-byte pages, 
including the header. 

06-07 Number of relocation entries in 
table. 

08-09 Size of the header in 16-byte para- 
graphs. This is used to locate the 
beginning of the load module in 
the file. 

OA-OB Minimum number of 16-byte para- 
graphs required above the end of 
the loaded program (minalloc). 

OC-OD Maximum number of 16-byte para- 
graphs required above the end of 
the loaded program (maxalloc). If 
both minalloc and maxalloc are 0, 
then the program will be loaded as 
high as possible. 
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OE-OF Initial value to be loaded into stack 
segment before starting program 
execution. This must be adjusted 
by relocation. 

10-11 Value to be loaded into the SP reg- 
ister before starting program exe- 
cution. 

12-13 Negative sum of all the words in 
the file. 

14-15 Initial value to be loaded into the 
IP register before starting program 
execution. 

16-17 Initial value to be loaded into the 
CS register before starting pro- 
gram execution. This must be 
adjusted by relocation. 

18-19 Relative byte offset from beginning 
of run file to relocation table. 

1 A-IB The number of the overlays gener- 
ated by MS-LINK. 

This is followed by the relocation table. The 
table consists of a variable number of relocation 
items. Each relocation item contains two fields: 
a two-byte offset value, followed by a two-byte 
segment value. These two fields contain the 
offset into the load module of a word which 
requires modification before the module is given 
control. 



Program Structure 
and Loading 

Relocation Process for .EXE Files 



The following steps describe the relocation 
process: 

1 The formatted part of the header is read into 
memory. Its size is IBH. 

2 A portion of memory is allocated depending on 
the size of the load module and the allocation 
numbers (OA-OB and OC-OD). MS-DOS attempts 
to allocate FFFFH paragraphs. This will always 
fail, returning the size of the largest free block. If 
this block is smaller than minalloc and loadsize, 
then there will be a no memory error. If this 
block is larger than maxalloc and loadsize, MS- 
DOS will allocate (maxalloc + loadsize). Other- 
wise, MS-DOS will allocate the largest free block 
of memory. 

3 A Program Segment Prefix is built in the lowest 
part of the allocated memory. 

4 The load module size is calculated by subtract- 
ing the header size from the file size. Offsets 04- 
05 and 08-09 can be used for this calculation. 
The actual size is downward-adjusted based on 
the contents of offsets 02-03. Based on the set- 
ting of the high/low loader switch, an appropri- 
ate segment is determined at which to load the 
load module. This segment is called the start 
segment. 
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5 The load module is read into memory beginning 
with the start segment. 

6 The relocation table items are read into a work 
area. 

7 Each relocation table item segment value is 
added to the start segment value. This calcu- 
lated segment, plus the relocation item offset 
value, points to a word in the load module to 
which is added the start segment value. The 
result is placed back into the word in the load 
module. 

8 Once all relocation items have been processed, 
the SS and SP registers are set from the values 
in the header. Then, the start segment value is 
added to SS. The ES and DS registers are set to 
the segment address of the Program Segment 
Prefix. The start segment value is added to the 
header CS register value. The result, along with 
the header IP value, is the initial CS:IP to 
transfer to before starting execution of the 
program. 
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Program Segment Prefix 



Unless you specify otherwise when Unking your 
program, DOS loads your program in the lowest 
memory address available, immediately follow- 
ing the DOS code. This occurs whether the pro- 
gram loads as a result of your entering its name 
at the DOS prompt or through your use of the 
EXEC (4BH) function call. The area into which 
your program is loaded is called the Program 
Segment. 

DOS requires control information for each run- 
ning program: it builds a Program Segment 
Prefix and places it at offset within the pro- 
gram segment. The Program Segment Prefix is 
hex 100 bytes long, so your program is loaded at 
relative address lOOH. 
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Program Structure 
and Loading 



PSP Format 

HEXO 



10 



INT 20H 


End of 

alloc. 

block 


Reserved 


Length of program 
segment, in 
bytes 




Terminate address 
(IP,CS) 


CTRL-C exit 
address(IP) 


CTRL-C exit 
address(CS) 


Hard error exit address 
(IP,CS) 





50 



80 



100 



Used by DOS 
2CH 
5CH 



Function dispatch call 



Formatted Parameter Area 1 formatted as standard 
unopened FCB 

6CH 



Formatted Parameter Area 2 formatted as standard 
unopened FCB (overlaid if FCB at 5CH is opened) 



Unformatted Parameter Area 
(default Disk Transfer Area) 
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and Loading 



HEX 

OFFSET CONTENTS 






Return address used by interrupt hex 20 


2 


Segment address of allocatable memory following this 
program (If this program calls a memory management 
function to get more memory, this is its starting 
address.) 


4 


Reserved 


6 


Number of bytes in this program segment (2 byte value) 


8 Not used 


A 


Terminate address : IP 


C 


Terminate address : CS 


E 


Ctrl break exit : IP 


10 


Ctrl break exit : CS 


12 


Critical error exit : IP 


14 


Critical error exit : CS 


2C 


Segment address of the USED 
environment by DOS 


50 


Code to call function dispatcher for 
DOS (INT 21H) interrupts 


5C 


Formatted parameter area 1: 
formatted as standard, unopened FCB 


6C 


Formatted parameter area 2: 
formatted as standard, unopened FCB 


80 
81 


Count of argument characters that These comprise 
follow the command name. the default DTA: 

Disk Transfer 

The argument characters Area(80H - FFH) 
themselves. 
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Program Structure 
and Loading 



Program Loading Process 



PSP When a program receives control, the following 

Conditions conditions are in effect: 

upon 

Program • The segment address of the passed environment 
Initiation is contained at offset 2CH in the Program Seg- 
ment Prefix. The environment is a series of 
ASCII strings (totaling less than 32K) in the 
form: 



NAME = parameter 



Each string is terminated by a byte of zeros, and 
the set of strings is terminated by another byte 
of zeros. The environment built by the command 
processor contains at least a COMSPEC= string 
(the parameters on COMSPEC define the path 
used by MS-DOS to locate C0MMAND.COM on 
disk). The last PATH and PROMPT commands 
issued will also be in the environment, along 
with any environment strings defined with the 
MS-DOS SET command. 



The environment that is passed is a copy of the 
invoking process environment. If your applica- 
tion uses a "keep process" concept, be aware 
that the copy of the environment passed to you 
is static. That is, it will not change even if sub- 
sequent SET, PATH, or PROMPT commands 
are issued. 
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and Loading 



• Offset 50H in the Program Segment Prefix con- 
tains code to call the MS-DOS function dis- 
patcher. After correctly loading the registers, a 
program can issue a far call to offset 50H to 
invoke an MS-DOS function, rather than issuing 
an Interrupt 21H. Since this is a call and not an 
interrupt, MS-DOS may place any code appro- 
priate to making a system call at this position. 
This makes the process of calling the system 
portable. 

• The Disk Transfer Address (DTA) is set to 80H 
(default DTA in the Program Segment Prefix). 

• File control blocks at 5CH and 6CH are format- 
ted from the first two parameters typed when 
the command was entered. If either parameter 
contains a pathname, then the corresponding 
FOB contains only the valid drive number. The 
filename field will not be valid. 

• An unformatted parameter area at 81H contains 
all the characters typed after the command 
(including leading and imbedded delimiters), 
with the byte at 80H set to the number of char- 
acters. If the < or > parameters were typed on 
the command line, they (and the filenames asso- 
ciated with them) do not appear in this area or 
in the character count; redirection of standard 
input and output is transparent to applications. 

• Offset 6 (one word) contains the number of bytes 
available in the segment. 
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and Loading 



• Register AX indicates whether or not the drive 
specifiers (entered with the first two parameters) 
are vahd, as follows: 

AL=FF if the first parameter contained an invalid 
drive specifier (otherwise AL=00) 

AH=FF if the second parameter contained an 
invalid drive specifier (otherwise AH=00) 

• Offset 2 (one word) contains the segment 
address of the first byte of unavailable memory. 
Programs must not modify addresses beyond 
this point unless they were obtained by allocat- 
ing memory via the Allocate Memory system 
call (Function Request 48H). 



Initial • DS and ES registers are set to point to the Pro- 
Conditions gram Segment Prefix, 
for .EXE 

Programs • CS, IP, SS, and SP registers are set to the values 
passed by MS-LINK. 
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Program Structure 
and Loading 



Initial 
Conditions 
for .COM 
Programs 



All four segment registers contain the segment 
address of the initial allocation block that starts 
with the Program Segment Prefix control block. 

The Instruction Pointer (IP) is set to lOOH. 



• The Stack Pointer register is set to the end of the 
program's segment. The segment size at offset 6 
is reduced by lOOH to allow for a stack of that 
size. 



• A word of zeros is placed on top of the stack. 
This allows your program to exit to COM- 
MAND.COM by doing a RET instruction last. 
Make sure, however, to maintain your stack and 
code segments. 
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and Loading 



Other Uses of In MS-DOS versions prior to 2.0, the PSP con- 
the Program tained the mechanism for program termination. 
Segment One of these four techniques had to be used to 

Prefix terminate your programs: 



1 A long jump to offset in the Program Segment 
Prefix. 



2 By issuing an INT 20H with CS:0 pointing at 
the PSP. 



3 By issuing an INT 21H with register AH = and 
CS:0 pointing at the PSP. 



4 By a long call to location 50H in the Program 
Segment Prefix with AH = and CS:0 pointing 
at the PSP. 



It is the responsibility of all programs to ensure 
that the CS register contains the segment 
address of the Program Segment Prefix when 
terminating via any of these methods. 



However, with the 2.0 Terminate a Process sys- 
tem call (Function Request 4CH), the CS register 
need not point to the Program Segment Prefix. 
For this reason. Function Request 4CH is the 
preferred method. It may be invoked by loading 
the AH register with 4CH and issuing an INT 
21 H (or a long call to offset 50H in the Program 
Segment Prefix). 
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System Calls 



• Quick Reference: Functions and 
Interrupts 

• Overview 

• Programming Considerations 

• Interrupts 

• Functions 

• System Call Descriptions 
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System Calls 



Functions 



Number 


Function Name 


Number 


Function Name 


OOH 


Terminate Program 


30H 


Get DOS Version 


OIH 


Read Keyboard and 




Number 




Echo 


31H 


Keep Process 


02H 


Display Character 


33H 


<CTRL C> Check 


03H 


Auxiliary Input 


35H 


Get Interrupt Vector 


04H 


Auxiliary Output 


36H 


Get Disk Free Space 


05H 


Print Character 


38H 


Return Country- 


06H 


Direct Console I/O 




Dependent Info. 


07H 


Direct Console Input 


39H 


Create Sub-Directory 


08H 


Read Keyboard 


3AH 


Remove a Directory 


09H 


Display String 


3BH 


Change the Current 


OAH 


Buffered Keyboard 




Directory 




Input 


3CH 


Create a File 


OBH 


Check Keyboard Status 


3DH 


Open a File Handle 


OCH 


Flush Buffer, Read 


3EH 


Close a File Handle 




Keyboard 


3FH 


Read From File/Device 


ODH 


Disk Reset 


40H 


Write to a File/Device 


OEH 


Select Disk 


41H 


Delete a Directory Entry 


OFH 


Open File 


42H 


Move a File Pointer 


lOH 


Close File 


43H 


Change Attributes 


IIH 


Search for First Entry 


44H 


I/O Control for Devices 


12H 


Search for Next Entry 


45H 


Duplicate a File Handle 


13H 


Delete File 


46H 


Force a Duplicate of a 


14H 


Sequential Read 




Handle 


15H 


Sequential Write 


47H 


Return Name of Current 


16H 


Create File 




Directory 


17H 


Rename File 


48H 


Allocate Memory 


19H 


Current Disk 


49H 


Free Allocated Memory 


lAH 


Set Disk Transfer 


4AH 


Modify Allocated 




Address 




Memory Blocks 


21H 


Random Read 


4BH 


Load and Execute a 


22H 


Random Write 




Program (EXEC) 


23H 


File Size 


4CH 


Terminate a Process 


24H 


Set Relative Record 


4DH 


Retrieve the Return 


25H 


Rot \/ £a/~'4'/~\T' 
k^cL V c^L'KJl 




v^ode oi a v^niid 


27H 


Random Block Read 


4EH 


Find Match File 


28H 


Random Block Write 


4FH 


Step Through a Di- 


29H 


Parse File Name 




rectory Matching Files 


2AH 


Get Date 


54H 


Return Current Setting 


2BH 


Set Date 




of Verify 


2CH 


Get Time 


56H 


Move a Directory Entry 


2DH 


Set Time 


57H 


Get/Set Date/Time of 


2EH 


Set/Reset Verify Flag 




File 


2FH 


Get Disk Transfer 








Address 
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System Calls 



Function Name 


Number 


Allocate Memory- 


48H 


Auxiliary Input 


03H 


Auxiliary Output 


04H 


Buffered Keyboard 




Input 


OAH 


Change Attributes 


43H 


Change the Current 




Directory 


3BH 


Check Keyboard Status 


/-NT-) T T 

OBH 


Close a File Handle 


3EH 


Close File 


lOH 


CTRL C Check 


33H 


Create a File 




Create File 


-1 /-'TT 

ioH 


Create Sub-Directory 


39H 


Current Disk 


19H 


Delete a Directory Entry 


41H 


Delete File 


13H 


Direct Console Input 


07H 


Direct Console I/O 


06H 


Disk Reset 


ODH 


Display Character 


02H 


Display String 


09H 


Duplicate a File Handle 


45H 


File Size 


23H 


Find Match File 


4EH 


Flush Buffer, Read 




Keyboard 


OCH 


Force a Duplicate of a 




Handle 


46H 


Free Allocated Memory 


49H 


Get Date 


2AH 


Get Disk Free Space 


O /"'TT 

36H 


Get Disk Transfer 




Address 


fl 


Get DOS Version 




Number 


30H 


Get Interrupt Vector 


35H 


Get Time 


2CH 


Get/Set Date/Time of 




File 


57H 


I/O Control for Devices 


44H 


Keep Process 


31H 


Load and Execute a 




Program (EXEC) 


4BH 



Function Name Number 



^ M 1-r R11 j_ 1 

Modify Allocated 




Memory Blocks 




Move a Directory Entry 


ecu 
ODH 


Move a File Pointer 


4zrl 


Open a rue rlandle 


■DUti 


Open File 


Ur n. 


Parse File Name 


zyri 


Print Character 


Uorl 


Random Block Read 


O'7'tJ 

Z Jn 


Random Block Write 


zon 


Random Read 


O 1 IT 
/S, ifl 


Random Write 




Read From File/Device 


ovu 
or n 


Read Keyboard 


Ucsrl 


Read Keyboard and 




Echo 


Uirl 


Remove a Directory 


o s tl 
oArl 


Rename File 


L J n 


Retrieve the Return 




Code of a Child 


4iJrl 


Return Current Setting 




of Verify 


b4ri 


Return Country- 




•f-v 1 i. T I 

Dependent Into. 


oorl 


Return Name of Current 




Directory 


4- / rl 


Search for First Entry 


1 irl 


Search for Next Entry 


1 OTJ 


Select Disk 


/-VT7TT 

Utrl 


Sequential Read 


i4rl 


Sequential Write 


iOrl 


Set Date 


2BH 


Set Disk Transfer 




Address 


lAH 


Set Relative Record 


24H 


Set Time 


2DH 


Set Vector 


25H 


Set/Reset Verify Flag 


2EH 


Step Through a Di- 




rectory Matching 


4FH 


Terminate a Process 


4CH 


Terminate Program 


OOH 


Write to a File/Device 


40H 
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Interrupts 



Interrupts 
(in Numerical 
Order) 



Interrupt 


Interrupt 




(Hex) 


(Decimal) 


IDescription 


ZUrl 


00 

sz 


Program Terminate 


21ri 


33 


Function Request 




34 


m • X All 

1 ermmate Address 


23H 


35 


<CTRL C> Exit Address 


24H 


36 


Fatal Error Abort 






Address 


25H 


37 


Absolute Disk Read 


26H 


38 


Absolute Disk Write 


27H 


39 


Terminate But Stay 






Resident 


28-40H 


40-64 


RESERVED - DO NOT 






USE 



Interrupts 


Interrupt 


Interrupt 


in Alphabetical Description 


in Hex 


in Dec 


Order 






Absolute Disk Read 


25H 


37 


Absolute Disk Write 


26H 


38 


<CTRL C> Exit Address 


23H 


35 


Fatal Error Abort 






Address 


24H 


36 


Function Request 


21H 


33 


Program Terminate 


20H 


32 


RESERVED - DO NOT 






USE 


28-40H 


40-64 


Terminate Address 


22H 


34 


Terminate But Stay 






Resident 


27H 


39 
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System Calls 



Overview 



System Calls are procedures used to interface 
with I/O or to manage memory. They can be 
accessed from utility programs written in 
assembly language, and from some high level 
languages. Their use frees the programmer from 
having to perform primitive functions, and 
makes it easier to write machine-independent 
programs. 

MS-DOS provides two types of system calls: 
interrupts and function requests. This chapter 
describes the environments from which these 
routines can be called, how to call them, and the 
processing performed by each. 
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System Calls 



Programming Considerations 



System calls can be invoked from Assembly 
Language, from GW BASIC, or from high-level 
languages like PASCAL and FORTRAN. This 
section describes the techniques for invoking 
calls and for returning control to MS-DOS. 



Calling from The system calls can be invoked from Assembly 
Assembly Language simply by moving any required data 
Language into registers and issuing an interrupt. Some of 
the calls destroy registers, so you may have to 
save registers before using a system call. 



Calling from The BLOAD and BSAVE commands are used 
GW BASIC for loading and saving machine language pro- 
grams. These are then called, using the CALL 
statement. 

The USR function calls an indicated machine 
language subroutine. The starting address of the 
subroutine must first be specified in a DEF USR 
statement. 
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System Calls 



Interrupts 



MS-DOS reserves interrupts 20H through 3FH 
for its own use. The table of interrupt routine 
addresses (vectors) is maintained in locations 
80H-FCH. User programs should only issue 
Interrupts 20H, 21H, 25H, 26H, and 27H. (Func- 
tions Requests 4CH and 31H are the preferred 
method for Interrupts 20H and 27H for versions 
of MS-DOS that are 2.0 and higher. 

Interrupts 22H, 23H, and 24H are not interrupts 
that can be issued by user programs; they are 
simply locations where a segment and offset 
address are stored. For a discussion, see the sec- 
tion on Address Interrupts in this chapter. 
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System Calls 



Functions 



Requirements Most of the MS-DOS function calls require input 
to be passed to them in registers. After setting 
the proper register values, the function may be 
invoked in one of the following ways: 

• Place the function number in AH and execute a 
long call to offset 50H in your Program Segment 
Prefix. Note that programs using this method 
will not operate correctly on versions of MS-DOS 
that are lower than 2.0. 

• Place the function number in AH and issue 
Interrupt 21H. All of the examples in this chap- 
ter use this method. 

• An additional method exists for programs that 
were written with different calling conventions. 
This method should be avoided for all new pro- 
grams. The function number is placed in the CL 
register and other registers are set according to 
the function specification. Then, an intraseg- 
ment call is made to location 5 in the current 
code segment. That location contains a long call 
to the MS-DOS function dispatcher. Register AX 
is always destroyed if this method is Used; other- 
wise, it is the same as normal function calls. 
Note that this method is valid only for Function 
Requests OOH through 024H. 
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This chapter provides the following type of 
information for each DOS interrupt and func- 
tion call: 

a description of the register contents required 
before the system call 

a description of the register contents after the 
system call 

a description of the processing performed 
an example of its use. 



Registers When MS-DOS takes control after a function 
call, it switches to an internal stack. Registers 
not used to return information (except AX) are 
preserved. The calling program's stack must be 
large enough to accommodate the interrupt sys- 
tem — at least 128 bytes in addition to other 
needs. 



Note The macro definitions and extended example for 

MS-DOS system calls OOH through 2EH can be 
found at the end of this chapter. 
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System Call Descriptions 



Interrupts The following are not true interrupts but rather 
storage locations for a segment and offset 
address: 

• Terminate Address (Interrupt 22H) 

• CTRL C Exit Address (Interrupt 23H) 

• Fatal Error Abort Address (Interrupt 24H) 

The interrupts are issued by MS-DOS under the 
specified circumstance. You can change any of 
these addresses with Function Request 25H (Set 
Vector) if you prefer to write your own interrupt 
handlers. 



Programming 
Examples 



A macro is defined for most system calls, then 
used in some examples. In addition, a few other 
macros are defined for use in the examples. The 
use of macros allows the examples to be more 
complete programs, rather than isolated uses of 
the system calls. All macro definitions are Hsted 
at the end of the chapter. 

The examples are not intended to represent good 
programming practice. In particular, error check- 
ing and good human interface design have been 
sacrificed to conserve space. You may, however, 
find the macros a convenient way to include sys- 
tem calls in your assembly language programs. 

A detailed description of each system call follows. 
They are listed in numeric order; the interrupts 
are described first, then the function requests. 



Note 



Unless otherwise stated, all numbers in the sys- 
tem call descriptions, both text and code, are in 
hex. 
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20H 

Program Terminate 



Call 



cs 



Segment address of Program Segment 
Prefix 



Return None 



Remarks All open file handles are closed and the disk 
cache is cleaned. The current process is termi- 
nated and control returns to the parent process. 
This interrupt is almost always used in old 
.COM files for termination. 

The CS register must contain the segment 
address of the Program Segment Prefix before 
you call this interrupt. 

The following exit addresses are restored from 
the Program Segment Prefix: 



Exit Address Offset 

Program Terminate OAH 
<CTRL C> OEH 
Critical Error 12H 

All file buffers are flushed to disk. 
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20H 

Program Terminate 



Note Close all files that have changed in length 

before issuing this interrupt. If a changed file is 
not closed, its length is not recorded correctly in 
the directory. See Functions lOH and 3EH for a 
description of the Close File system calls. 

Interrupt 20H is provided for compatibility with 
versions of MS-DOS prior to 2.0. New programs 
should use Function Request 4CH, Terminate a 
Process. 



Macro terminate macro 

int 20H 
endm 



Example ;CS must be equal to PSP values given at program 

; start 

;(ES and DS values) 
INT 20H 

;There is no return from this interrupt 
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21H 

Function Request 



Call 



Return 
Remarks 



Note 



Example 
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AH 

Function number 
Other registers as specified in 
individual function 



As specified in individual function 



The AH register must contain the number of the 
system function. See the following section on 
Function Requests, in this chapter, for a descrip- 
tion of the MS-DOS system functions. 



No macro is defined for this interrupt, because 
all function request descriptions in this chapter 
that define a macro include Interrupt 21H. 

To call the Get Time function: 

mov ah,2CH ;Get Time is Function 2CH 
int 21H ;THIS INTERRUPT 



22H 

Terminate Address 



When a program terminates, control transfers to 
the address at offset OAH of the Program Seg- 
ment Prefix. This address is copied into the Pro- 
gram Segment Prefix, from the Interrupt 22H 
vector, when the segment is created. Interrupt 
22H, then, is just a storage location for an 
address rather than a true interrupt. 
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23H 

<CTRL C> Exit Address 



If the user types CTRL C during keyboard input 
or display output, control transfers to the INT 
23H vector in the interrupt table. This address is 
copied into the Program Segment Prefix, fi*om 
the Interrupt 23H vector, when the segment is 
created. 

If the CTRL C routine preserves all registers, it 
can end with an IRET instruction (return from 
interrupt) to continue program execution. When 
the interrupt occurs, all registers are set to the 
value they had when the original call to MS- 
DOS was made. There are no restrictions on 
what a CTRL C handler can do — including 
MS-DOS function calls — so long as the regis- 
ters are unchanged if IRET is used. 

If Function 09H or OAH (Display String or Buf- 
fered Keyboard Input) is interrupted by CTRL 
C, the three-byte sequence 03H-0DH-0AH (ETX- 
CR-LF) is sent to the display and the function 
resumes at the beginning of the next line. 

If the program creates a new segment and loads 
a second program that changes the CTRL C 
address, termination of the second program re- 
stores the CTRL C address to its value before 
execution of the second program. 

Like INT 22H, this is really not a true interrupt, 
but a storage location. 
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24H 

Fatal Error Abort Address 



Call If a fatal disk error occurs during execution of 

one of the disk I/O function calls, control 
transfers to the INT 24H vector in the vector 
table. This address is copied into the Program 
Segment Prefix, from the Interrupt 24H vector, 
when the segment is created. 



Return BP:SI contains the address of a Device Header 

Control Block from which additional informa- 
tion can be retrieved. 



Note Interrupt 24H is not issued if the failure occurs 

during execution of Interrupt 25H (Absolute 
Disk Read) or Interrupt 26H (Absolute Disk 
Write). These errors are usually handled by the 
MS-DOS error routine in C0MMAND.COM that 
retries the disk operation, then gives the user the 
choice of aborting, retrying the operation, or 
ignoring the error. The following topics give you 
the information you need about interpreting the 
error codes, managing the registers and stack, 
and controlling the system's response to the 
error in order to write your own error-handling 
routines. 



Error Codes When an error-handling program gains control 
from Interrupt 24H, the AX and DI registers can 
contain codes that describe the error. If Bit 7 of 
AH is 1, the error is either a bad image of the 
File Allocation Table or an error which has oc- 
curred on a character device. The device header 
passed in BP:SI can be examined to determine 
which case exists. If the attribute byte high 
order bit indicates a block device, then the error 
was a bad FAT. Otherwise, the error is on a 
character device. 
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24H 

Fatal Error Abort Address 



The following are error codes for Interrupt 24H: 



Error Code Description 

Attempt to write on write- 
protected disk 

1 Unknown unit 

2 Drive not ready 

3 Unknown command 

4 Data error 

5 Bad request structure length 

6 Seek error 

7 Unknown media type 

8 Sector not found 

9 Printer out of paper 
A Write fault 

B Read fault 

C General failure 



The user stack will be in effect (the first item 
described below is at the top of the stack), and 
will contain the following from top to bottom: 



IP MS-DOS registers from 

CS issuing INT 24H 

FLAGS 

AX User registers at time of original 

BX INT 2 IH request 

CX 

DX 

SI 

DI 

BP 

DS 

ES 

IP From the original INT 2 IH 

CS from the user to MS-DOS 

FLAGS 



The registers are set such that if an IRET is exe- 
cuted, MS-DOS will respond according to (AL) 
as follows: 
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24H 

Fatal Error Abort Address 



(AL) = ignore the error 
= 1 retry the operation 
= 2 terminate the program via INT 23H 



Note • Before giving this routine control for disk errors, 

MS-DOS performs five retries. 

• For disk errors, this exit is taken only for errors 
occurring during an Interrupt 21H. It is not used 
for errors during Interrupts 25H or 26H. 

• This routine is entered in a disabled state. 



The SS,SP,DS,ES,BX,CX, and DX registers must 
be preserved. 

The interrupt handler should refrain from using 
MS-DOS function calls. If necessary, it may use 
calls OIH through OCH. Use of any other call 
will destroy the MS-DOS stack and will leave 
MS-DOS in an unpredictable state. 

The interrupt handler must not change the con- 
tents of the device header. 



• If the interrupt handler will handle errors rather 
than returning to MS-DOS, it should restore the 
application program's registers from the stack, 
remove all but the last three words on the stack, 
then issue an IRET. This will return to the pro- 
gram immediately after the INT 21H that expe- 
rienced the error. Note that if this is done, MS- 
DOS will be in an unstable state until a function 
call higher than OCH is issued. 
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25H 

Absolute Disk Read 



Call AL 

Drive number (0 = A, 1 = B, etc.) 
DS:BX 

Disk Transfer Address 
CX 

Number of sectors 
DX 

Beginning relative sector 



Return Flags 

CF = if successful 
= 1 if not successful 

AL 

Error code if CF = 1 



Remarks This interrupt transfers control to the MS-DOS 
BIOS. The number of sectors specified in CX is 
read from the disk to the Disk Transfer Address, 
Its requirements and processing are identical to 
Interrupt 26H, except data is read rather than 
written. 



7-19 



25H 

Absolute Disk Read 



Note All registers except the segment registers are 

destroyed by this call. Be sure to save any regis- 
ters your program uses before issuing the 
interrupt. 

The system pushes the flags at the time of the 
call; they are still there upon return. (This is 
necessary because data is passed back in the 
flags). Be sure to pop the stack upon return to 
restore your stack pointer at the point of 
invocation. 

If the disk operation was successful, the Carry 
Flag (CF) is 0. If the disk operation was not suc- 
cessful, CF is 1 and AL contains the MS-DOS 
error code (see Interrupt 24H earlier in this sec- 
tion for the codes and their meaning). 

Macro aby_disk_read macro disk, buffer, num_sectors, start 

mov al,disk 
mov bx,offset buffer 
mov cx,num_sectors 
mov dx, start 
int 25H 
endm 
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25H 

Absolute Disk Read 



Example The following program copies the contents of a 

single-sided disk in drive A: to the disk in drive 
B:. It uses a buffer of 32K bytes: 

prompt db "Source in A, target in B",13,10 

db "Any key to start. $" 
start dw 

buffer db 64 dup (512 dup (?)) ;64 sectors 



int_25H: display prompt ;see Function 09H 
read_kbd ;see Function 08H 

mov cx,5 ;copy 5 groups of 

;64 sectors 

copy: push cx ;save the loop 

;counter 

abs_disk_read 0,buffer, 64,start ;THIS 
;INTERRUPT 

abs_disk_write 1, buffer, 64, start ;see INT 
;26H 

add start, 64 ; do the next 64 

;sectors 

pop cx ;restore the loop 

;counter 

loop copy 
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26H 

Absolute Disk Write 



Call AL 

Drive number (0 = A, 1 = B, etc.) 
DS:BX 

Disk Transfer Address 
CX 

Number of sectors 
DX 

Beginning relative sector 



Return FLAGS 

CF = if successful 
= 1 if not successful 

AL 

Error code ifCF = 1 



Remarks This interrupt transfers control to the MS-DOS 
BIOS. The number of sectors specified in CX is 
written from the Disk Transfer Address to the 
disk. Its requirements and processing are identi- 
cal to Interrupt 25H, except data is written to the 
disk rather than read fi-om it. 
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26H 

Absolute Disk Write 



Note All registers except the segment registers are 

destroyed by this call. Be sure to save any regis- 
ters your program uses before issuing the 
interrupt. 

The system pushes the flags at the time of the 
call; they are still there upon return. (This is 
necessary because data is passed back in the 
flags). Be sure to pop the stack upon return to 
restore your stack pointer at the point of 
invocation. 

If the disk operation was successful, the Carry 
Flag (CF) is 0. If the disk operation was not suc- 
cessful, CF is 1 and AL contains the MS-DOS 
error code (see Interrupt 24H earlier in this sec- 
tion for the codes and their meaning). 



Macro abs_disk_write macro disk, buffer, num_sectors, start 

mov al,disk 
mov bx, offset buffer 
mov cx,num_sectors 
mov dx, start 
int 26H 
endm 
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26H 

Absolute Disk Write 



Example The following program copies the contents of a 
single-sided disk in drive A: to the disk in drive 
B:, verifying each write. It uses a buffer of 32K 
bytes: 

off equ 

on equ 1 



prompt db "Source in A, target in B", 13,10 

db "Any key to start. $" 
start dw 

buffer db 64 dup (512 dup (?)) ; 64 sectors 



int_26H: display prompt ;see Function 09H 

read_kbd ;see Function 08H 

verify on ;see Function 2EH 

movcx,5 ;copy 5 groups of 

;64 sectors 

copy: push cx ;save the loop 

; counter 

abs_disk_read 0,buffer, 64,start ;see INT 
;25H 

abs_disk_write l,buffer, 64,start ;THIS 
;INTERRUPT 

add start, 64 ;do the next 64 

; sectors 

pop cx ;restore the loop 

; counter 

loop copy 

verify off ;see Function 2EH 
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27H 

Terminate But Stay Resident 



Call 



CCS:DX 

First byte following 
last byte of code 



Return 



None 



Remarks The Terminate But Stay Resident call is used to 
make a piece of code remain resident in the sys- 
tem after its termination. Typically, this call is 
used in .COM files to allow some device-specific 
interrupt handler to remain resident to process 
asynchronous interrupts. 

DX must contain the number of bytes in the CS 
segment to be reserved. When Interrupt 27H is 
executed, the program terminates but is treated 
as an extension of MS-DOS; it remains resident 
and is not overlaid by other programs when it 
terminates. 

If an executable file whose extension is .COM or 
.EXE ends with this interrupt, it becomes a resi- 
dent operating system command. 

This interrupt is provided for compatibility with 
versions of MS-DOS prior to 2.0. New programs 
should use Function 31 H, Keep Process. 



Macro 



stay_resident macro last_instruc 
mov dx, offset last_instruc 
inc dx 
int 27H 
endm 
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27H 

Terminate But Stay Resident 



Example 



CS must be equal to PSP values given at program 
start 

(ES and DS values) 

the variable Last Address must be equal 
to the offset of the last byte in the 
program. 

mov DX, Last Address 

inc dx 

int 27H 
;There is no return from this interrupt 
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OOH 

Terminate Program 



Call 



AH = OOH 
CS 

Segment address of 
Program Segment Prefix 



Return 



None 



Remarks Function OOH is called by Interrupt 20H; it per- 
forms the same processing. 



The CS register must contain the segment 
address of the Program Segment Prefix before 
you call this interrupt. 

The following exit addresses are restored from 
the specified offsets in the Program Segment 
Prefix: 



Program terminate OAH 
<CTRL C> OEH 
Critical error 12H 



All file buffers are flushed to disk. 



Warning Close all files that have changed in length be- 

fore calling this function. If a changed file is not 
closed, its length is not recorded correctly in the 
directory. See Function lOH for a description of 
the Close File system call. 
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OOH 

Terminate Program 



Macro terminate_program macro 

xor ah,ah 
int 21H 
endm 



Example ;CS must be equal to PSP values given at program start 
;(ES and DS values) 

mov ah,0 

int 21H 
;There are no returns from this interrupt 
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OIH 

Read Keyboard and Echo 



Call 



AH = OIH 



Return 



AL 

Character typed 



Remarks Function OIH waits for a character to be typed 
at the keyboard, then echoes the character to the 
display and returns it in AL. If the character is 
CTRL C, Interrupt 23H is executed. 



Macro 



read_kdb_and_echo macro 
mov ah,01H 



int 

endm 



21H 



Example The following program both displays and prints 

characters as they are typed. If CR is pressed, 
the program sends Line Feed-Carriage Return to 
both the display and the printer: 



func_01H: read_kbd_and_ echo 
print_char 
cmp 
jne 

print_char 
display _char 
imp 



;THIS FUNCTION 
al ;see Function 05H 

al,ODH ;is it a CR? 
func_01H ;no, print it 
10 ;see Function 05H 

10 ;see Function 02H 

func_01H ;get another character 
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02H 

Display Character 



Call 



AH = 02H 
DL 

Character to be displayed 



Return 



None 



Remarks 



If CTRL C is typed, Interrupt 23H is issued. 



Macro 



display _char macro character 
mov dl,character 
mov ah,02H 
int 21H 
endm 



Example The following program converts lowercase char- 

acters to uppercase before displaying them: 



func_02H: 



uppercase: 



read-kbd 

cmp al,"a" 

jl uppercase 

cmp al,"z" 

jg uppercase 

sub al,20H 

display _char al 
jmp func_02H 



;see FUNCTION 08H 

;don't convert 

;don't convert 
;convert to ASCII code 
;for uppercase 
;THIS FUNCTION 
;get another character 
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03H 

Auxiliary Input 



Call 



AH = 03H 



Return 



AL 



Character from auxiliary device 



Remarks Function 03H waits for a character from the 
auxiliary input device, then returns the 
character in AL. 

This system call does not return a status or error 
code. 

If a CTRL C has been typed at console input, 
Interrupt 23H is issued. 



Macro 



aux_input macro 
mov ah,03H 
int 21H 
endm 



Example The following program prints characters as they 

are received from the auxiliary device. It stops 
printing when an end-of-file character (ASCII 
26, or CTRL Z) is received: 



func_03H: aux_input 

cmp al, lAH 

je continue 
print_char al 
jmp func_03H 

continue: 



;THIS FUNCTION 
;end of file? 
;yes, all done 
;see Function 05H 
;get another character 
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04H 

Auxiliary Output 



Call 



AH = 04H 
DL 

Character for auxiliary device 



Return 



None 



Remarks This system call does not return a status or error 
code. 

If a CTRL C has been typed at console input, 
Interrupt 23H is issued. 



Macro 



aux_Dutput macro character 
mov dl,character 
mov ah,04H 
int 21H 
endm 



Example 



string 



The following program gets a series of strings of 
up to 80 bytes from the keyboard, sending each 
to the auxiliary device. It stops when a null 
string (CR only) is typed: 



db 



82 dup(?) 



;see Function OAH 



func_04H: get_string 80,string 
cmp string[l],0 
je continue 
xor ch,ch 

mov cl, byte ptr string[l] 

mov bx,0 
send_it: aux_output string[bx+2] 

inc bx 

loop send_it 

jmp func_04H 
continue: . 



;see Function OAH 

;null string? 

;yes, all done 

;zero high byte 

;get string length 

;set index to 

;THIS FUNCTION 

;bump index 

;send another character 

;get another string 
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05H 

Print Character 



Call 



AH = 05H 
DL 

Character for printer 



Return 



None 



Remarks If CTRL C has been typed at console input, 
Interrupt 23H is issued. 



Macro 



print_char macro character 
mov dl,character 
mov ah,05H 
int 21H 
endm 
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05H 

Print Character 



Example The following program prints a walking test pat- 

tern on the printer. It stops if CTRL C is pressed. 



aJD 


U 




mov 


bl,33 


;first printable ASCII 






; character (!) 


add 


bl,line_num 


;to offset next character 


mov 


cx,80 


;loop counter for Une 


print- 


_char bl 


;THIS FUNCTION 


inc 


bl 


;move to next ASCII character 


cmp 


bl,126 


;last printable ASCII 






(•character (~) 


jle 


no_reset 


;not there yet 


mov 


bl,33 


;start over with (!) 



no_reset: loop print_it ; print another character 

print_char 13 ;carriage return 

print_char 10 ;line feed 

inc line_num ;to offset 1st char, of line 

cmp line_num, 93 ;end of cycle? 

jle func_05H ;nope, not yet 

mov line_num, ; reset char offset 

jmp func_05H ;continue 



7-34 



06H 

Direct Console 1/0 



Call AH = 06H 

DL 

See Text 



Return AL 

If DL = FFH before call 
If Zero flag not set: 

Character from keyboard 
If Zero flag set: 

No character input 



Remarks Processing depends on the value in DL when the 
function is called: 

DLisFFH. 

If a character has been typed at the keyboard, 
it is returned in AL and the Zero flag is 0; if 
a character has not been typed, the Zero flag 
is 1. 

DLisnotFFH. 

The character in DL is displayed. 

This function does not check for CTRL C. 

Macro dir_console_io macro switch 

mov dl, switch 
mov ah,06H 
int 21H 
endm 
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06H 

Direct Console I/O 



Example The following program acts as a stopwatch. 

When a character is typed, it sets the system 
clock to zero and begins to continuously display 
the time. When a second character is typed the 
system stops updating the time display. 



time db"00:00:00.00",13,"$' 
ten db 10 



func_06H: dir_console_io OFFH 
jz func_06H 
set_tiine 0,0,0,0 

read_clock: get_time 

convert ch,ten,time 
convert cl,ten,time[3] 
convert dh,ten,time[6] 
convert dl,ten,time[9] 
display time 
dir_console_io OFFH 
jz read_clock 

continue: 



;THIS FUNCTION 
;wait for keystroke 
;see Function 2DH 
;see Function 2CH 
;see end of chapter 
;see end of chapter 
;see end of chapter 
;see end of chapter 
;see Function 09H 
;THIS FUNCTION 
;no char, keep updating 
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07H 

Direct Console Input 



Call 



AH = 07H 



Return 



AL 

Character from keyboard 



Remarks This function does not echo the character or 

check for CTRL C. (For a keyboard input func- 
tion that echoes or checks for CTRL C, see 
Functions 01 H or 08H.) 



Macro dir_console_input macro 

mov ah,07H 
int 21H 
endm 



Example The following program fragment prompts for a 

password (8 characters maximum) and places 
the characters into a string without echoing 
them: 



password 
prompt 



db 
db 



8 dup(?) 
"Password: 



$" ;see Function 09H for 
; explanation of $ 



func_07H: 



get_pass: 



display prompt 

mov cx,8 

xor bx,bx 

dir_console_input 

cmp al,ODH 

je continue 

mov password[bx],al 

inc bx 

loop get_pass 



continue: 



;see Function 09H 

; maximum length of password 

;so BL can be used as index 

;THIS FUNCTION 

;was it a OR? 

;yes, all done 

;no, put character in string 
;bump index 
;get another character 
;BX has length of password 
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08H 

Read Keyboard 



Call 
Return 



AH = 08H 
AL 

Character from keyboard 



Remarks If CTRL C is pressed, Interrupt 23H is executed. 

This function does not echo the character. (For a 
keyboard input function that echoes the charac- 
ter or does not check for CTRL C, see Functions 
OIH or 07H.) 



Macro 



read_kbd macro 

mov ah,08H 
int 21H 
endm 



Example The following program fragment prompts for a 

password (8 characters maximum) and places 
the characters into a string without echoing 
them: 



password 
prompt 



db 
db 



8 dup(?) 
"Password: 



$" ;see Function 09H 

;for explanation of $ 



func_08H: 



get_pass: 



display prompt 

mov cx,8 

xor bx,bx 

read_kbd; 

cmp al,ODH 

je continue 

mov password[bx],al 

inc bx 

loop get_pass 



continue: 



;see Function 09H 

(•maximum length of password 

;BL can be an index 

;THIS FUNCTION 

;was it a OR? 

;yes, all done 

;no, put char, in string 

;bump index 

;get another character 

;BX has length of password 
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09H 

Display String 



Call 



AH = 09H 
DS:DX 

String to be displayed 



Return 



None 



Remarks DX must contain the offset (from the segment 
address in DS) of a string that ends with "$". 
The string is displayed (the $ is not displayed). 



Macro 



display macro string 
mov dx,offset string 
mov ah,09H 
int 21H 
endm 



Example The following program displays the hexadec- 

imal code of the key that is typed: 



table 

sixteen 

result 



db "0123456789ABCDEF" 
db 16 



db "-00H",13,10,"$" 



;see text for 
;explanation of $ 



func_09H: read_kbd_and_echo ;see Function OIH 

convert al, sixteen, result [1] ;see end of chapter 
display result ;THIS FUNCTION 

jmp func_09H ;do it again 
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OAH 

Buffered Keyboard Input 



Call AH = OAH 

DS:DX 

Input buffer 



Return None 



Remarks DX must contain the offset (from the segment 
address in DS) of an input buffer of the 
following form: 

Byte Contents 

1 Maximum number of characters in 
buffer, including the CR (you must set 
this value). 

2 Actual number of characters typed, not 
counting the CR (the function sets this 
value). 

3-n Buffer; must be at least as long as the 
number in byte 1. 

This function waits for characters to be typed. 
Characters are read from the keyboard and 
placed in the buffer beginning at the third byte 
until CR is pressed. If the buffer fills to one less 
than the maximum, additional characters typed 
are ignored and ASCII 7 (BEL) is sent to the 
display until CR is pressed. The string can be 
edited as it is being entered. If CTRL C is typed, 
Interrupt 23H is issued. 

The second byte of the buffer is set to the 
number of characters entered (not counting the 
CR). 
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OAH 

Buffered Keyboard Input 



Macro get_string macro limit, string 

mov dx, offset string 
mov string,limit 
mov ah, OAH 
int 21H 
endm 



Example The following program gets a 16-byte (maxi- 

mum) string from the keyboard and fills a 24- 
line by 80-character screen with it: 



buffer label byte 

max_length db ? 

chars_entered db ? 

string db 17 dup (?) 

strings_per_line dw 

crlf db 13,10,"$" 



; maximum length 
;number of chars. 
;16 chars + CR 
;how many strings 
;fit on line 



func_OAH: 



get_string 17, buffer 
xor bx,bx 



display-Screen: 
display_line: 



mov 
mov 
mov 
cbw 
div 

xor 

mov 

mov 

push cx 

mov 

display 

loop 

display 

pop 

loop 



bl, chars_entered 
buffer[bx+2],"$" 
al,50H 

chars_entered 
ah,ah 

strings_per_line, ax 
cx,24 

cx, strings_per_line 
string 

display _line 

crlf 

cx 

display_screen 



;THIS FUNCTION 
;so byte can be 
;used as index 
;get string length 
;see Function 09H 
; columns per line 

;times string fits 
;on line 

;clear remainder 
;save col. counter 
;row counter 
;save it 

;get col. counter 
;see Function 09H 

;see Function 09H 
;get line counter 
/display 1 more line 
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OBH 

Check Keyboard Status 



Call 



AH = OBH 



Return 



AL 



FFH = characters in type-ahead buffer 
= no characters in type-ahead buffer 



Remarks Checks whether there are characters in the type- 
ahead buffer. If so, AL returns FFH; if not, AL 
returns 0. If CTRL C is in the buffer, Interrupt 
23H is executed. 



Macro 



check_kbd_status macro 
mov ah, OBH 
int 21H 
endm. 



Example The following program fragment continuously 

displays the time until any key is pressed. 

time db "00:00:00.00", 13, 10,"$" 

ten db 10 



func_OBH: get_time 



convert ch,ten,time 
convert cl,ten,time[3] 
convert dh,ten,time[6] 
convert dl,ten,time[9] 
display time 
check_kbd_status 
cmp al,OFFH 
je all_done 
jmp func_OBH 



;see Function 2CH 
;see end of chapter 
;see end of chapter 
;see end of chapter 
;see end of chapter 
;see Function 09H 
;THIS FUNCTION 
;has a key been typed 
;yes, go home 
;no, keep displaying 
;time 



all-done: 
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OCH 

Flush Buffer, Read Keyboard 



Call AH = OCH 

AL 

1, 6, 7, 8, or OAH = The corresponding 
function is called. Any other value 
= return from function. 



Return AL 

= Type-ahead buffer was flushed; no 
other processing performed. 



Remarks The keyboard type-ahead buffer is emptied. 

Further processing depends on the value in AL 
when the function is called: 

1,6, 7, 8, or A: 
The corresponding MS-DOS function is 
executed. 

Any other value: 

No further processing; AL returns 0. 



Macro flush_and_read_kbd macro switch 

mov al, switch 
mov ah, OCH 
int 21H 
endm 
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OCH 

Flush Buffer, Read Keyboard 



Example The following program both displays and prints 

characters as they are typed. If CR is pressed, 
the program sends Carriage Return-Line Feed to 
both the display and the printer. 



func_OCH: flush_and_read_kbd 1 



print_char 

cmp 

jne 

print_char 
display_char 
print_char 
display _char 
imp 



al 

al,ODH 

func_OCH 

10 

10 

13 

13 

func_OCH 



;THIS FUNCTION 
;see Function 05H 
;is it a CR? 
;no, print it 
;see Function 05H 
;see Function 02H 
;see Function 05H 
;see Function 02H 
;get another character 
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ODH 
Disk Reset 



Call 



AH = ODH 



Return 



None 



Remarks Function ODH is used to ensure that the internal 

buffer cache matches the disks in the drives. If 
buffers have been modified, but not yet written 
to disk, this function writes them out and marks 
all buffers in the internal cache as free. 

Function ODH flushes (frees) all file buffers. It 
does not update directory entries; you must close 
files that have changed to update their directory 
entries (see Function lOH, Close File). This func- 
tion need not be called before a disk change if all 
files that changed were closed. It is generally 
used to force a known state of the system; 
CTRL C interrupt handlers should call this 
function. 



Macro 



disk_reset macro disk 
mov ah,ODH 
int 21H 
endm 



Example 



mov ah,ODH 
int 21H 
;There are no errors returned by this call. 
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OEH 

Select Disk 



Call 



Return 



Remarks 



Macro 



Example 



AH = OEH 
DL 

Drive number 

(0 = A:, 1 = B:, etc.) 



AL 

Number of logical drives 

The drive specified in DL (0 = A:, 1 = B:, etc.) is 
selected as the default disk. The number of 
drives is returned in AL. 



select-disk macro disk 

mov dl,disk[-65] ;ASCII offset 
mov ah,OEH 
int 21H 
endm 

The following program fragment selects the 
drive not currently selected in a 2-drive system: 

func_OEH: current_disk ;see Function 19H 



selectJD: select_disk ^^B" ;THIS FUNCTION 



cmp al,OOH 
je select_b 
select-disk "A" 
jmp continue 



;drive A: selected? 
;yes, select B 
;THIS FUNCTION 



continue: 
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OFH 
Open File 



Call AH = OFH 

DS:DX 

Unopened FCB 



Return AL 

= Directory entry found 
FFH = No directory entry found 



Remarks DX must contain the offset (from the segment 
address in DS) of an unopened File Control 
Block (FCB). The disk directory is searched for 
the named file. 

If a directory entry for the file is found, AL 
returns and the FCB is filled as follows: 

• If the drive code was (default disk), it is 
changed to the actual disk used (1 = A:, 2 = B:, 
etc.). This lets you change the default disk with- 
out interfering with subsequent operations on 
this file. 

• The Current Block field (offset OCH) is set to 
zero. 

• The Record Size (offset OEH) is set to the system 
default of 128. 

• The File Size (offset lOH), Date of Last Write 
(offset 14H), and Time of Last Write (offset 16H) 
are set from the directory entry. 

Before performing a sequential disk operation 
on the file, you must set the Current Record field 
(offset 20H). Before performing a random disk 
operation on the file, you must set the Relative 
Record field (offset 21H). If the default record 
size (128 bytes) is not correct, set it to the correct 
length. 
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OFH 

Open File 



If a directory entry for the file is not found, AL 
returns FFH. 



Macro open macro fcb 

mov dx, offset fcb 
mov ah, OFH 
int 21H 
endm 



Example The following program prints the file named 

TEXTFILE. ASC that is on the disk in drive B:. 
If a partial record is in the buffer at end-of-file, 
the routine that prints the partial record prints 
characters until it encounters an end-of-file mark 
(ASCII 26, or CTRL Z): 



fcb 


db 


2/TEXTFILEASC" 




db 


25 dup (?) 




buffer 


db 


128 dup (?) 




func_OFH: 


set_dta buffer 


;see Function lAH 




open 


fcb 


;THIS FUNCTION 


read-line: 


read- 


-seq fcb 


;see Function 14H 




cmp 


al,01H 


;end of file? 




je 


all_done 


;yes, go home 




cmp 


al,OOH 


;more to come? 




jg 


check_more 


;no, check for partial 








;record 




mov 


cx,128 


;yes, print the buffer 




xor 


si,si 


;set index to 


print_it: 


print. 


_char buffer[si] 


;see Function 05H 




inc 


si 


;bump index 




loop 


print_it 


; print next character 




imp 


read-line 


;read another record 


check_more: 


cmp 


al,03H 


;part. record to print? 




jne 


all-done 


;no 
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OFH 
Open File 



find_eof: 



alLdone: 



mov cx,128 
xor si, si 
cmp buffer[si],26 
je all-done 
print_char buffer[si] 
inc si 



loop 
close 



find_eof 
fcb 



;yes, print it 
;set index to 
;end-of-file mark? 
;yes 

;see Function 05H 
;bunip index to next 
;character 

;see Function lOH 
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lOH 

Close File 



Call 



AH = lOH 
DS:DX 

Opened FCB 



Return 



AL 

= Directory entry found 
FFH = No directory entry found 



Remarks DX must contain the offset (to the segment 
address in DS) of an opened FCB. The disk 
directory is searched for the file named in the 
FCB. This function must be called after a file is 
changed to update the directory entry. 

If a directory entry for the file is found, the entry 
is compared with the corresponding entries in 
the FCB. The directory entry is updated, if 
necessary, to match the FCB, and AL returns 0. 

If a directory entry for the file is not found, AL 
returns FFH. 



Macro 



close macro fcb 
mov dx,offset fcb 
mov ah,10H 
int 21H 
endm 
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lOH 
Close File 



Example The following program checks the first byte of 

the file named MODl.BAS in drive B: to see if it 
is FFH, and prints a message if it is: 

message db "Not saved in ASCII format", 13, 10,"$" 

fob db 2, "MODI BAS" 

db 25 dup (?) 

buffer db 128 dup (?) 



func_10H: set_dta buffer ;see Function lAH 

open fcb ;see Function OFH 

read^eq fcb ;see Function 14H 

cmp buffer, OFFH ;is first byte FFH? 

jne all_done ;no 

display message ;see Function 09H 

alLdone close fcb ;THIS FUNCTION 
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IIH 

Search for First Entry 



Call AH = IIH 

DS:DX 

Unopened FCB 



Return AL 

= Directory entry found 
FFH = No directory entry found 



Remarks DX must contain the offset (from the segment 

address in DS) of an unopened FCB. The disk 
directory is searched for the first matching 
name. The name can have the ? wild card char- 
acter to match any character. To search for hid- 
den or system files, DX must point to the first 
byte of the extended FCB prefix. 

If a directory entry for the filename in the FCB 
is found, AL returns and an unopened FCB of 
the same type (normal or extended) is created at 
the Disk Transfer Address. 

If a directory entry for the filename in the FCB 
is not found, AL returns FFH. 



Note If an extended FCB is used, the following search 

pattern is used: 

• If the FCB attribute is zero, only normal file 
entries are found. Entries for volume label, sub- 
directories, hidden, and system files will not be 
returned. 
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Search for First Entry 



• If the attribute field is set for hidden or system 
files, or directory entries, it is to be considered as 
an inclusive search. All normal file entries plus 
all entries matching the specified attributes are 
returned. To look at all directory entries except 
the volume label, the attribute byte may be set to 
hidden + system + directory (all 3 bits on). 

• If the attribute field is set for the volume label, it 
is considered an exclusive search, and only the 
volume label entry is returned. 



Macro search_first macro fcb 

mov dx,offset fcb 
mov ah,llH 
int 21H 
endm 



Example The following program verifies the existence of a 

file named REPORT. ASM on the disk in drive 
B:: 

yes db "FILE EXISTS. $" 

no db "FILE DOES NOT EXIST. $" 

fcb db 2, "REPORT ASM" 

db 25 dup (?) 
buffer db 128 dup (?) 

crlf db 13,10"$" 



func_llH: 



not_there: 
continue: 



set_dta buffer 
search_first fcb 
cmp al,OFFH 
je not_there 
display yes 
jmp continue 
display no 
display crlf 



;see Function lAH 
;THIS FUNCTION 
(•directory entry found? 
;no 

;see Function 09H 

;see Function 09H 
;see Function 09H 
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Search for Next Entry 



Call 



AH = 12H 
DS:DX 

Unopened FCB 



Return 



AL 

= Directory entry found 
FFH = No directory entry found 



Remarks DX must contain the offset (from the segment 

address in DS) of an FCB previously specified in 
a call to Function llH (Search for First Entry). 
Function 12H is used after Function IIH to find 
additional directory entries that match a file- 
name that contains wild card characters. The 
disk directory is searched for the next matching 
name. 

If a directory entry for the filename in the FCB 
is found, AL returns and an unopened FCB of 
the same type (normal or extended) is created at 
the Disk Transfer Address. 

If a directory entry for the filename in the FCB 
is not found, AL returns FFH. 



Macro 



search_next macro fcb 
mov dx,offset fcb 
mov ah,12H 
int 21H 
endm 
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Search for Next Entry 



Example The following program displays the number of 

files on the disk in drive B: 

message db "No files", 10, 13,"$" 

files db 

ten db 10 

fcb db 2,"???????????" 

db 2'5dup (?) 

buffer db 128 dup (?) 



fuiic_12H: set_dta buffer 
search-first fcb 
cmp al,OFFH 
je all-done 
inc files 

search_dir: search-next fcb 
cmp al,OFFH 
je done 
inc files 

jmp search-dir 
done: convert files, ten, message 

all-done: display message 



;see Function lAH 
;see Function IIH 
; directory entry found? 
;no, no files on disk 
;yes, increment file 
; counter 

;THIS FUNCTION 

; directory entry found? 

;no 

;yes, increment file 

;counter 

;check again 

;see end of chapter 

;see Function 09H 
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Delete File 



Call 



AH = 13H 
DS:DX 

Unopened FCB 



Return 



AL 

= Directory entry found 
FFH = No directory entry found 



Remarks DX must contain the offset (from the segment 
address in DS) of an unopened FCB. The direc- 
tory is searched for a matching filename. The 
filename in the FCB can contain the ? wild card 
character to match any character. 

If a matching directory entry is found, it is 
deleted from the directory. If the ? wild card 
character is used in the filename, all matching 
directory entries are deleted. AL returns 0. 

If no matching directory entry is found, AL 
returns FFH. 



Macro 



delete macro f cb 
mov dx,offset fcb 
mov ah,13H 
int 21H 
endm 
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Example The following deletes each file on the disk in 

drive B: that was last written before June 30, 
1984: 



year 


dw 


1984 


month 


db 


6 


day 


db 


30 


files 


db 





ten 


db 


10 


message 


db 


"NO FILES DELETED.", 13, 10,"$" 






;see Function 09H 






;explanation of $ 


fcb 


db 


2 "???????????" 




db 


25 dup(?) 


buffer 


db 


128 dup (?) 



func_13H: 



compare: 



next: 



set_dta buffer 
search-first fcb 
cmp al,0FFH 
je all-done 

convert-date buffer 
cmp cx,year 
jg next 
cmp dl,month 
jg next 
cmp dh,day 
jge next 
delete buffer 
inc files 

search_next fcb 
cmp al,00H 
je compare 
cmp files, 
je all-done 



;see Function lAH 
;see Function IIH 
;directory entry found? 
;no, no files on disk 

;see end of chapter 
;next several lines 
;check date in directory 
;entry against date 
;above & check next file 
;if date in directory 
;entry isn't earlier, 
;THIS FUNCTION 
;bump deleted-files 
; counter 

;see Function 12H 
;directory entry found? 
;yes, check date 
;any files deleted? 
;no, display NO FILES 
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;message. 

convert files,ten,message ;see end of chapter 
all_done: display message ;see Function 09H 
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Sequential Read 



Call AH = 14H 

DS:DX 

Opened FOB 



Return AL 

= Read completed successfully 

1 = EOF 

2 = DTA too small 

3 = EOF, partial record 



Remarks DX must contain the offset (from the segment 
address in DS) of an opened FCB. The record 
pointed to by the current block (offset OCH) and 
Current Record (offset 20H) fields is loaded at 
the Disk Transfer Address, then the Current 
Record and, if necessary, the Current Block 
fields are incremented. 

The record size is set to the value at offset OEH 
in the FCB. 

AL returns a code that describes the processing: 

Code Meaning 

Read completed successfully. 

1 End-of-file, no data in the record. 

2 Not enough room at the Disk 
Transfer Address to read one 
record; read canceled. 

3 End-of-file; a partial record was 
read and padded to the record 
length with zeros. 
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Sequential Read 



Macro read_seq macro fcb 

mov dx, offset fcb 
mov ah,14H 
int 21H 
endm 



Example The following program displays the file named 

TEXTFILE.ASC that is on the disk in drive B:; 
its function is similar to the MS-DOS TYPE 
command. If a partial record is in the buffer at 
end of file, the routine that displays the partial 
record displays characters until it encounters an 
end-of-file mark (ASCII 26, or CTRL Z ): 

fcb db 2,"TEXTFILEASC" 

db 25 dup (?) 
buffer db 128 dup (?),"$" 



func_14H: set_dta buffer 
open fcb 

read-line: read_seq fcb 
cmp al,01H 
je all-done 
cmp al,OOH 
jg check-more 
display buffer 
jmp read -line 

check_more: cmp al,03H 

jne all -done 
xor si, si 

find_eof: cmp buffer[si],26 

je all -done 
display -char buffer[si] 
inc si 



see Function lAH 
see Function OFH 
THIS FUNCTION 
end-of-file? 
yes 

more to come? 

no, check for partial record 

see Function 09H 

get another record 

partial record in buffer? 

no, go home 

set index to 

is character EOF? 

yes, no more to display 

see Function 02H 

bump index to next 
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(■character 

imp find_eof ;check next character 

all_done: close fcb ;see Function lOH 
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Sequential Write 



Call AH = 15H 

DS:DX 

Opened FCB 



Return AL 

OOH = Write completed successfully 
OIH = Disk full 
02H = DTA too small 



Remarks DX must contain the offset (from the segment 
address in DS) of an opened FCB. The record 
pointed to by Current Block (offset OCH) and 
Current Record (offset 20H) fields is written from 
the Disk Transfer Address, then the fields are 
incremented as necessary. 

The record size is set to the value at offset OEH 
in the FCB. If the Record Size is less than a sec- 
tor, the data at the Disk Transfer Address is 
written to a buffer; the buffer is written to disk 
when it contains a full sector of data, or the file 
is closed, or a Reset Disk system call (Function 
ODH) is issued. 

AL returns a code that describes the processing: 

Code Meaning 

transfer completed successfully 

1 disk full; write canceled 

2 write canceled; the area beginning at 
the Disk Transfer Address is too small 
to hold a record of data without over- 
flowing or wrapping around a seg- 
ment boundary. 
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Sequential Write 



Macro write_seq macro fcb 

mov dx, offset fcb 
mov ah, 15H 
int 21H 
endm 



Example The following program creates a file named 

DIR.TMP on the disk in drive B: that contains 
the disk number (0 = A:, 1 = B:, etc.) and file- 
name from each directory entry on the disk: 

record_size equ 14 ;offset of Record Size 

;field in FCB 



fcbl 
fcb2 
buffer 



db 
db 
db 
db 
db 



2,"DIR TMP" 
25 dup (?) 
2/7??????????' 
25 dup (?) 
128 dup (?) 



func_15H: 



write_it: 



all_done: 



set_dta buffer ;see Function lAH 

search_first fcb2 ;see Function IIH 

cmp al,OFFH ; directory entry found? 

je all_done ;no, no files on disk 

create fcbl ;see Function 16H 

mov fcbl[record_size],12 

;set record size to 12 

write_seq fcbl ;THIS FUNCTION 

search_next fcb2 ;see Function 12H 

cmp al,OFFH ; directory entry found? 

je all_done ;no, go home 

jmp write_it ;yes, write the record 

close fcbl ;see Function lOH 
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Create File 



Call AH = 16H 

DS:DX 

Unopened FCB 



Return AL 

OOH = Empty directory entry found 

FFH = No empty entry directory available 



Remarks DX must contain the offset (from the segment 
address in DS) of an unopened FCB. The direc- 
tory is searched for an empty entry or an exist- 
ing entry for the specified filename. 

If an empty directory entry is found, it is initial- 
ized to a zero-length file, the Open File system 
call (Function OFH) is called, and AL returns 0. 
You can create a hidden file by using an extend- 
ed FCB with the attribute byte (offset FCB-1) set 
to 2. 

If an entry is found for the specified filename, all 
data in the file is released, making a zero-length 
file, and the Open File system call (Function 
OFH) is issued for the filename (in other words, 
if you try to create a file that already exists, the 
existing file is erased, and a new, empty file is 
created). 

If an empty directory entry is not found and 
there is no entry for the specified filename, AL 
returns FFH. 
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Macro create macro fcb 

mov dx, offset fcb 
mov ah,16H 
int 21H 
endm 



Example The following program creates a file named 

DIR.TMP on the disk in drive B: that contains 
the disk number (0 = A:, 1 = B:, etc.) and file- 
name firom each directory entry on the disk: 

record_size equ 14 ;offset of Record Size 

;field of FCB 



fcbl db 2,"DIR TMP" 

db 25 dup (?) 

fcb2 db 2,"???????????" 

db 25 dup (?) 

buffer db 128 dup (?) 



func_16H: 



write_it: 



all-done: 



first 



set_dta 
search- 
cmp 
je 

create 
mov 



write_seq 

search_next 

cmp 

je 

jmp 
close 



buffer ;see Function lAH 

fcb2 ;see Function IIH 

al,OFFH ; directory entry found? 

all_done ;no, no files on disk 

fcbl ;THIS FUNCTION 
fcbl[record_size], 12 

;set record size to 12 

fcbl ;see Function 15H 

fcb2 ;see Function 12H 

al,OFFH ; directory entry found? 

all_done ;no, go home 

write_it ;yes, write the record 

fcbl ;see Function lOH 
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Rename File 



Call AH = 17H 

DS:DX 

Modified FCB 



Return AL 

OOH = Directory entry found 
FFH = No directory entry found or 
destination already exists 



Remarks DX must contain the offset (from the segment 

address in DS) of an FCB with the drive number 
and filename filled in, followed by a second file- 
name at offset IIH. The disk directory is search- 
ed for an entry that matches the first filename, 
which can contain the ? wild card character. 

If a matching directory entry is found, the file- 
name in the directory entry is changed to match 
the second filename in the modified FCB (the 
two filenames cannot be the same name). If the ? 
wild card character is used in the second file- 
name, the corresponding characters in the file- 
name of the directory entry are not changed. AL 
returns 0. 

If a matching directory entry is not found or an 
entry is found for the second filename, AL 
returns FFH. 
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Rename File 



Macro rename macro special_fcb 

mov dx,offset special^fcb 
mov ah,17H 
int 21H 
endm 



Example The following program prompts for the name of 

a file and a new name, then renames the file: 



fcb 

promptl 
prompt2 
reply 
crlf 



db 
db 
db 
db 
db 



37 dup (?) 
"Filename: $" 
"New name: $" 
17 dup(?) 
13,10,"$" 



func_17H: display promptl ;see Function 09H 
get_string 15,reply ;see Function OAH 
display crlf ;see Function 09H 

parse reply[2],fcb ;see Function 29H 
display prompt2 ;see Function 09H 
get_string 15,reply ;see Function OAH 
display crlf ;see Function 09H 

parse reply[2],fcb[16] 

;see Function 29H 
rename fcb ;THIS FUNCTION 
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Current Disk 



Gall 
Return 

Macro 
Example 



AH = 19H 



AL 

Currently selected drive 
(0 = A:, 1 = B:, etc.) 



current_disk macro 
mov ah, 19H 
int 21H 
endm 



The following program displays the currently 
selected (default) drive: 

3 db "Current disk is $" ;see Function 09H 



;fbr explanation of $ 



db 13,10,"$" 



func_19H: 



display message 
current-disk 
add al, 41H 
display _char al 
display crlf 



;see Function 09H 
;THIS FUNCTION 
;ASCII offset 



;see function 02H 
;see function 09H 
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Set Disk Transfer Address 



Call 



AH = lAH 
DS:DX 

Disk Transfer Address 



Return None 



Remarks DX must contain the offset (from the segment 
address in DS) of the Disk Transfer Address. 
Disk transfers cannot wrap around from the end 
of the segment to the beginning, nor can they 
overflow into another segment. 



Note: 



If you do not set the Disk Transfer Address, 
MS-DOS defaults to offset 80H in the Program 
Segment Prefix. 

The size of the buffer that the DTA points to 
must be greater than or equal to the record size 
at open file time. 



Macro 



set_dta macro buffer 
mov dx,offset buffer 
mov ah, lAH 
int 21H 
endm 
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Set Disk Transfer Address 



Example The following program prompts for a letter, con- 

verts the letter to its alphabetic sequence (A = 1, 
B = 2, etc.), then reads and displays the corre- 
sponding record from a file named ALPHABET.- 
DAT on the disk in drive B:. The file contains 26 
records; each record is 28 bytes long: 



record -Size equ 14 
relative -record equ 33 



offset of Record Size 
field of FCB 

offset of Relative Record 
field of FCB 



fcb db 2,"ALPHABETDAT" 

db 25 dup (?) 

buffer db 34dup(?),"$" 

prompt db "Enter letter: $" 

crlf db 13,10,"$" 



func-lAH: set-dta buffer 
open fcb 

mov fcb[record-size],28 
get-char: display prompt 

read -kbd -and -echo 
cmp aI,ODH 
je all-done 
sub al,41H 

mov fcb[relative_recordl 

display crlf 
read-ran fcb 
display buffer 
display crlf 
imp get_char 
all-done: close fcb 



THIS FUNCTION 
see Function OFH 
set record size 
see Function 09H 
see Function OIH 
just a CR? 
yes, go home 
convert ASCII 
code to record # 
al 

set relative record 
see Function d9H 
see Function 21H 
see Function 09H 
see Function 09H 
get another character 
see Function lOH 
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Random Read 



Call AH = 21H 

DS:DX 

Opened FCB 



Return AL 

OOH = Read completed successfully 

OIH = EOF 

02H = DTA too small 

03H = EOF, partial record 



Remarks DX must contain the offset (from the segment 
address in DS) of an opened FCB. The Current 
Block (offset OCH) and Current Record (offset 
20H) fields are set to agree with the Relative 
Record field (offset 21H), then the record 
addressed by these fields is loaded at the Disk 
Transfer Address. 

AL returns a code that describes the processing: 
Code Meaning 

read completed successfully 

1 End-of-file; no data in the record 

2 not enough room at the Disk Transfer 
Address to read one record; read can- 
celed 

3 End-of-file; a partial record was read 
and padded to the record length with 
zeros. 



Macro read _ran macro fcb 

mov dx, offset fcb 
mov ah,21H 
int 21H 
endm 



7-71 



21H 

Random Read 



Example The following program prompts for a letter, con- 
verts the letter to its alphabetic sequence (A = 1, 
B = 2, etc.), then reads and displays the corre- 
sponding record from a file named ALPHABET.- 
DAT on the disk in drive B:. The file contains 26 
records; each record is 28 bytes long: 



record_size equ 14 
relative_record equ 33 



offset of Record Size 
field of FCB 

offset of Relative Record 
field of FCB 



fcb db 2,"ALPHABETDAT" 

db 25 dup (?) 

buffer db 34dup(?),"$" 

prompt db "Enter letter: $" 

crlf db 13,10,"$" 



func_21H: set _dta buffer ; see Function 1 AH 

open fcb ;see Function OFH 

mov fcb[record_size],28;set record size 

get_char: display prompt ;see Function 09H 

read _kbd_and -echo ;see Function OIH 

cmp al,ODH ;just a CR? 

je all-done ;yes, go home 

sub al,41H ;convert ASCII 

;code to record # 
mov fcb[relative_record],al 

;set relative record 
display crlf ;see Function 09H 

read_ran fcb ;THIS FUNCTION 

display buffer ;see Function 09H 

display crlf ;see Function 09H 

jmp get_char ;get another character 

all-done: close fcb ;8ee Function lOH 



7-72 



22H 

Random Write 



Call AH = 22H 

DS.DX 

Opened FCB 



Return AL 

OOH = Write completed successfully 
OIH = Disk full 
02H = DTAtoo small 



Remarks DX must contain the offset from the segment 
address in DS of an opened FCB. The Current 
Block (offset OCH) and Current Record (offset 
20H) fields are set to agree with the Relative 
Record field (offset 21H), then the record 
addressed by these fields is written from the 
Disk Transfer Address. If the record size is 
smaller than a sector (512 bytes), the records are 
buffered until a sector is ready to write. 

AL returns a code that describes the processing: 

Code Meaning 

Write completed successfully 

1 disk is full 

2 write canceled; the area beginning at 
the Disk Transfer Area is too small to 
hold a record of data without over- 
flowing or wrapping around a seg- 
ment boundary. 



Macro write_ran macro fcb 

mov dxjoffset fcb 
mov ah,22H 
int 21H 
endm 
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Random Write 



Example The following program prompts for a letter, con- 

verts the letter to its alphabetic sequence (A = 1, 
B = 2, etc.), then reads and displays the corre- 
sponding record from a file named ALPHABET.- 
DAT on the disk in drive B:. After displaying the 
record, it prompts the user to enter a changed 
record. If the user types a new record, it is writ- 
ten to the file; if the user just presses CR , the 
record is not replaced. The file contains 26 
records; each record is 28 bytes long: 



record_size equ 14 
relative_record equ 33 



offset of Record Size 
field of FCB 

;offset of Relative Record 
;field of FCB 



fcb 


db 


2,"ALPHABETDAT" 




db 


25 dup (?) 


buffer 


db 


28dup(?),13,10,"$" 


promptl 


db 


"Enter letter: $" 


prompt2 


db 


"New record(CR for no change): $" 


crlf 


db 


13,10,"$" 


reply 


db 


30 dup (32) 


blanks 


db 


28 dup (32) 



func_22H: 



get_char: 



set_dta buffer ;see Function lAH 

open fcb ;see Function OFH 

mov fcb[record_size],28;set record size 



display promptl 
read _kbd _and _echo 



cmp 
je 

sub 
mov 



;see Function 09H 
;see Function OIH 
;just a CR? 
;yes, go home 
;convert ASCII 
;code to record # 
f cb[relative_record], al 

;set relative record 



al,ODH 

all-done 

al,41H 
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display crlf 
read_ran fcb 
display buffer 
display crlf 
display prompt2 
get_string 29, reply 
display crlf 
cmp reply[l],0 



all_done: 



;see Function 09H 
;THIS FUNCTION 
;see Function 09H 
;see Function 09H 
;see Function 09H 
;see Function 09H 
;see Function 09H 
;was anything typed 
;besides cr? 
get_char ;no 

;get another character 
bx,bx ;to load a byte 

bl,reply[l] ;use reply length as 

; counter 
move_string blanks, buffer, 28 

;see chapter end 
move-string reply[2], buffer, bx 

;see chapter end 
write_ran fcb ;THIS FUNCTION 

jmp get_char ;get another character 

close fcb ;see Function lOH 



]e 



xor 
mov 
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File Size 



Call AH = 23H 

DS:DX 

Unopened FCB 



Return AL 

OOH = Directory entry found 
FFH = No directory entry found 



Remarks DX must contain the offset (from the segment 
address in DS) of an unopened FCB. You must 
set the Record Size field (offset OEH) to the 
proper value before calling this function. The 
disk directory is searched for the first matching 
entry. 

If a matching directory entry is found, the Rela- 
tive Record field (offset 21H) is set to the number 
of records in the file, calculated from the total 
file size in the directory entry (offset lOH) and 
the Record Size field of the FCB (offset OEH). AL 
returns 00. 

If no matching directory entry is found, AL 
returns FFH. 



Note If the value of the Record Size field of the FCB 

(offset OEH) doesn't match the actual number of 
characters in a record, this function may not 
return the correct file size. If the default record 
size (128) is not correct, you must set the Record 
Size field to the correct value before using this 
function. 
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Macro file_size macro fob 

mov dx, offset fcb 
mov ah,23H 
int 21H 
endm 



Example The following program prompts for the name of 

a file, opens the file to set the Record Size field of 
the FCB to 80H, issues a File Size system call, 
and displays the file size and number of records 
in hexadecimal: 



fcb 


db 


37 dup(?) 




prompt 


db 


"File name: 


$" 


msgl 


db 


"Record length: ",13,10,"$" 


msg2 


db 


"Records: ' 


',13,10,"$" 


crlf 


db 


13,10,"$" 




reply 


db 


17 dup(?) 




sixteen 


db 


16 




func_23H: 


display prompt 


;see Function 09H 




get_string 17,reply 


;see Function OAH 




cmp 


reply[l],0 


;just a CR? 




jne 


get_length 


;no, keep going 




imp 


all -done 


;yes, go home 


get_length: 


display crlf 




;see Function 09H 




parse 


reply[2],fcb 


;see Function 29H 




open 


fcb 


;see Function OFH 




file_size fcb 




;THIS FUNCTION 




mov 


si,33 


; offset to Relative 








; Record field 




mov 


di,9 


; reply in msg2 


convert_it: 


cmp 


fcb[si],0 


; digit to convert? 




je 


show_it 


;no, prepare message 
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convert fcb[si],sixteen,msg2[di] 
inc si ;bunip n-o-r index 

inc di ;bump message index 

jmp convert_it ;check for a digit 

show_it: convert fcb[14],sixteen,msgl[15] 

display msgl ;see Function 09H 

display msg2 ;see Function 09H 

jmp func23H ;get a filename 

all_done: close fcb ;see Function lOH 
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Set Relative Record 



Call 



AH = 24H 
DS:DX 

Opened FCB 



Return 



None 



Remarks DX must contain the offset (from the segment 
address in DS) of an opened FCB. The Relative 
Record field (offset 21H) is set to the same file 
address as the Current Block (offset OCH) and 
Current Record (offset 20H) fields. 



Macro 



set_relative_record macro fcb 
mov dx,offset fcb 
mov ah,24H 
int 21H 
endm 



Example The following program copies a file using the 

Random Block Read and Random Block Write 
system calls. It speeds the copy by setting the 
record length equal to the file size and the record 
count to 1, and using a buffer of 32K bytes. It 
positions the file pointer by setting the Current 
Record field (offset 20H) to and using Set Rela- 
tive Record to make the Relative Record field 
(offset 21 H) point to the same record as the com- 
bination of the Current Block (offset OCH) and 
Current Record (offset 20H) fields: 
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24H 

Set Relative Record 



current_record equ 32 



fsize 



equ 16 



offset of Current Record 
field of FCB 
offset of File Size 
field of FCB 



fcb 

filename 
promptl 
prompt2 
crlf 

file_length 
buffer 



db 37 dup (?) 

db 17 dup(?) 

db "File to copy: $" 

db "Name of copy: $" 

db 13,10,"$" 

dw ? 

db 32767 dup(?) 



;see Function 09H for 
;explanation of $ 



func_24H: set_dta buffer 
display promptl 
get_string 15,filename 
display crlf 
parse filename[2],fcb 
open fcb 
mov fcb[current_record],0 

set_relative_record fcb 
mov ax, word ptr fcb[fsize] 
mov file_length,ax 

ran_block_read fcb, 1, ax 
display prompt2 
get_string 15,filename 
display crlf 
parse filename[2],fcb 
set_relative_record fcb 



;see Function lAH 
;see Function 09H 
;see Function OAH 
;see Function 09H 
;see Function 29H 
;see Function OFH 
;set Current Record 
;field 

;THIS FUNCTION 
;get file size 
;save it for 
;ran_block_write 
;see Function 27H 
;see Function 09H 
;see Function OAH 
;see Function 09H 
;see Function 29H 
;THIS FUNCTION 
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24H 

Set Relative Record 



mpv ax,file_length ;get original file 

;length 

ran_block_write fcb,l,ax ;see Function 28H 

close fcb ;see Function lOH 
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25H 

Set Vector 



Call 



AH = 25H 
AL 

Interrupt number 
DS:DX 

Interrupt-handling routine 



Return None 

Remarks Function 25H should be used to set a particular 
interrupt vector. The operating system can then 
manage the interrupts on a per-process basis. 
Note that programs should never set interrupt 
vectors by writing them directly in the low 
memory vector table. 

DX must contain the offset (to the segment 
address in DS) of an interrupt-handling routine. 
AL must contain the number of the interrupt 
handled by the routine. The address in the vec- 
tor table for the specified interrupt is set to 
DS:DX. 



Macro 



set_vector macro interrupt, seg_addr,off_addr 



push 


ds 


mov 


ax,seg_addr 


mov 


ds,ax 


mov 


dx,off_addr 


mov 


al,interrupt 


mov 


ah,25H 


int 


21H 


pop 


ds 


endm 





Example Ids dx,intvector 

mov ah,25H 
mov al,intnumber 
int 21H 

;There are no errors returned 



7-82 



27H 

Random Block Read 



Call AH = 27H 

DS:DX 

Opened FCB 
CX 

Number of blocks to read 

Return AL 

OOH = Read completed successfully 
01H = EOF 
02H = End of segment 
03H = EOF, partial record 
GX 

Number of blocks read 

Remarks DX must contain the offset (to the segment 

address in DS) of an opened FCB. CX must con- 
tain the number of records to read; if it contains 
0, the function returns without reading any 
records (no operation). The specified number of 
records, calculated from the Record Size field 
(offset OEH), is read starting at the record speci- 
fied by the Relative Record field (offset 21H). 
The records £ire placed at the Disk Transfer 
Address. 

AL returns a code that describes the processing: 

Code Meaning 

Read completed successfully 

1 End-of-file; no data in the record 

2 not enough room at the Disk Transfer 
Address to read one record without 
overflowing a segment boundary; read 
cancelled 

3 End-of-file; a partial record was read 
and padded to the record length with 
zeros 
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27H 

Random Block Read 



CX returns the number of records read; the Cur- 
rent Block (offset OCH), Current Record (offset 
20H), and Relative Record (offset 21H) fields are 
set to address the next record. 



Macro ran -block _read macro fcb,count,rec_size 

mov dx,offset fcb 
mov cx,count 

mov word ptr fcb[14],rec_size 
mov ah,27H 
int 21H 
endm 



Example The following program copies a file using the 

Random Block Read system call. It speeds the 
copy by specifying a record count of 1 and a 
record length equal to the file size, and using a 
buffer of 32K bytes; the file is read as a single 
record (compare to the sample program for 
Function 28H that specifies a record length of 1 
and a record count equal to the file size): 



current-record equ 32 



offset of Current Record 
field 



fsize 


equ 


16 


/offset of File Size 








;field 


fcb 


db 


37 dup (?) 




filename 


db 


17 dup(?) 




promptl 


db 


"File to copy: $" 


;see Function 09H for 


prompt2 


db 


"Name of copy: $" 


/explanation of $ 


crlf 


db 


13,10,"$" 




file-length 


dw 


? 




buffer 


db 


32767 dup(?) 




func_27H: 


set_ 


.dta buffer 


;see Function lAH 
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27H 

Random Block Read 



display promptl 
get_string 15,filename 
display crlf 
parse filename[2],fcb 
open fcb 

mov fcb[current_record],0 

set_relative_record fcb 
mov ax, word ptr fcb[fsize] 
mov file -length, ax 

ran_block_read fcb, 1, ax 
display prompt2 
get_string 15,filename 
display crlf 
parse filename[2],fcb 
create fcb 

mov fcb[current_record],0 

set_relative_record fcb 
mov ax, file -length 

ran_block_write fcb, 1, ax 
close fcb 



see Function 09H 
see Function OAH 
see Function 09H 
see Function 29H 
see Function OFH 
set Current Record 
field 

see Function 24H 
get file size 
save it for 
ran_block_write 
THIS FUNCTION 
see Function 09H 
see Function OAH 
see Function 09H 
see Function 29H 
see Function 16H 
set Current Record 
field 

see Function 24H 
get original file 
size 

see Function 28H 
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28H 

Random Block Write 



Call AH = 28H 

DS:DX 

Opened FCB 
CX 

Number of blocks to write 
(0 = set File Size field) 

Return AL 

OOH = Write completed successfully 
01H = Disk full 
02H = End of segment 
CX 

Number of blocks written 

Remarks DX must contain the offset (to the segment 

address in DS) of an opened FCB; CX must con- 
tain either the number of records to write or 0. 
The specified number of records (calculated from 
the Record Size field, offset OEH) is written from 
the Disk Transfer Address. The records are writ- 
ten to the file starting at the record specified in 
the Relative Record field (offset 21H) of the FCB. 
If CX is 0, no records are written, but the File 
Size field of the directory entry (offset lOH) is set 
to the number of records specified by the Rela- 
tive Record field of the FCB (offset 21H); alloca- 
tion units are allocated or released, as required. 

AL returns a code that describes the processing: 

Code Meaning 

Write completed successfully 

1 Disk full. No records written. 

2 Not enough room at the Disk Transfer 
Address to write one record without 
overflowing a segment boundary; 
write canceled. 
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28H 

Random Block Write 



CX returns the number of records written; the 
current block (offset OCH), Current Record 
(offset 20H), and Relative Record (offset 21H) 
fields are set to address the next record. 



Macro ran_block_write macro fcb, count, rec_size 

mov dx, offset fcb 

mov CX, count 

mov word ptr fcb[14],rec_size 

mov ah,28H 

int 21H 
endm 



Example The following program copies a file using the 
Random Block Read and Random Block Write 
system calls. It copies by specifying a record 
count equal to the file size and a record length of 
1, and using a buffer of 32K bytes; the file is 
copied with one disk access each to read and 
write (compare to the sample program of Func- 
tion 27H, that specifies a record count of 1 and a 
record length equal to file size): 



current-record equ 32 



fsize 



equ 16 



offset of Current Record 
field 

offset of File Size 
field 



fcb 

filename 
prompt 1 
prompt2 
crlf 

num_recs 
buffer 



db 37 dup (?) 

db 17 dup(?) 

db "File to copy: $" 

db "Name of copy: $" 

db 13,10,"$" 

dw ? 

db 32767 dup(?) 



;see Function 09H for 
;explanation of $ 
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28H 

Random Block Write 



func_28H: set_dta buffer 

display prompt 1 
get_string 15,filename 

display crlf 

parse filename[2],fcb 

open fcb 

mov fcb[current_record],0 

set_relative_record fcb 

mov ax, word ptr fcb[fsize] 

mov num_recs, ax 

ran_block_read fcb,num_recs,l 
display prompt2 
get_string 15,filename 
display crlf 
parse filename[2],fcb 
create fcb 

mov fcb[current_record],0 

set_relative_record fcb 
ran_block_write fcb,num_recs,l 
close fcb 



see Function lAH 
see Function 09H 
see Function OAH 
see Function 09H 
see Function 29H 
see Function OFH 
set Current Record 
field 

see Function 24H 
get file size 
save it for 
ran _block _write 
see Function 27H 
see Function 09H 
see Function OAH 
see Function 09H 
see Function 29H 
see Function 16H 
set Current Record 
field 

see Function 24H 
THIS FUNCTION 
see Function lOH 
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29H 

Parse File Name 



Call AH = 29H 

AL 

Controls parsing (see text) 
DS:SI 

String to parse 
ES:DI 

Unopened FCB 



Return AL 

OOH = No wild card characters 
01 H = Wild-card characters used 
FFH = Drive letter invalid 
DS:SI 

First byte past string that was parsed 
ES:DI 
Unopened FCB 



Remarks SI must contain the offset (to the segment ad- 
dress in DS) of a string (command line) to parse; 
DI must contain the offset (to the segment ad- 
dress in ES) of an unopened FCB. The string is 
parsed for a filename of the form d:filename.ext; 
if one is found, a corresponding unopened FCB 
is created at ES:DI. 

Bits 0-3 of AL control the parsing and process- 
ing. Bits 4-7 are ignored: 
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29H 

Parse File Name 



Bit Value Meaning 

All parsing stops if a file separator 

is encountered. 

1 Leading separators are ignored. 

1 The drive number in the FCB is set 

to (default drive) if the string does 
not contain a drive number. 

1 The drive number in the FCB is not 
changed if the string does not con- 
tain a drive number. 

2 The filename in the FCB is set to 8 

blanks if the string does not contain 
a filename. 

1 The filename in the FCB is not 

changed if the string does not con- 
tain a filename. 

3 The extension in the FCB is set to 3 

blanks if the string does not contain 
an extension. 

1 The extension in the FCB is not 
changed if the string does not con- 
tain an extension. 



If the filename or extension includes an asterisk 
(*), all remaining characters in the name or 
extension are set to question mark (?). 
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29H 

Parse File Name 



Filename separators: 

:.;, = + /"[] \<>| space tab 

Filename terminators include all the filename 
separators plus any control character. A file- 
name cannot contain a filename terminator; if 
one is encountered, parsing stops. 

If the string contains a valid filename: 

• AL returns 1 if the filename or extension con- 
tains a wild card character (* or ?); AL returns 
if neither the filename nor extension contains a 
wild card character. 

• DS:SI point to the first character following the 
string that was parsed. 

• ES:DI point to the first byte of the unopened 
FCB. 

If the drive letter is invalid, AL returns FFH. If 
the string does not contain a valid filename, 
ES:DI-H1 points to a blank (ASCII 20H). 



29H 

Parse File Name 



Macro parse macro string, fcb 

mov si, offset string 
mov di, offset fcb 
push es 
push ds 
pop es 

mov al,OFH ;bits 0, 1, 2, 3 on 

mov ah,29H 

int 21H 

pop es 

endm 



Example The following program verifies the existence of 

the file named in reply to the prompt: 



fcb 


db 


37 dup (?) 


prompt 


db 


"Filename: $" 


reply 


db 


17 dup (?) 


yes 


db 


"FILE EXISTS", 13,10,"$" 


no 


db 


"FILE DOES NOT EXIST", 13,10,"$" 


crlf 


db 


13,14,"$" 



func_29H: 



not_there: 
continue: 



display 


prompt 


;see Function 09H 


get_string 


15, reply 


;see Function OAH 


display 


crlf 


;see Function 09H 


parse 


reply[2],fcb 


;THIS FUNCTION 


search -first 


fcb 


;see Function IIH 


cmp 


al,OFFH 


;dir. entry found? 


je 


not_there 


;no 


display 


yes 


;see Function 09H 


jmp 


continue 




display 


no 
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2AH 
Get Date 



Call 
Return 



AH = 2AH 



CX 

Year (1980-2099) 
DH 

Month (1-12) 
DL 

Day (1-31) 
AL 

Day of week (0 = Sunday, 6 = Saturday) 



Remarks This function returns the current date set in the 
operating system as binary numbers in CX and 
DX: 

CX Year (1980-2099) 

DH Month (1 = January, 2 = February, etc.) 
DL Day (1-31) 

AL Day of week (0 = Sunday, 1 = Monday, 
etc.) 



Macro 



get_date macro 

mov ah, 2 AH 
int 21H 
endm 



Example The following program gets the date, increments 

the day, increments the month or year, if neces- 
sary, and sets the new date: 
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2AH 
Get Date 



month 



db 



31,28,31,30,31,30,31,31,30,31,30,31 



func_2AH: 



month _ok: 



get —date 




;see above 


inc 


dl 


;increment day 


xor 


bx,bx 


;so BL can be used as index 


mov 


bl,dh 


;move month to index register 


dec 


bx 


; month table starts with 


cmp 


dl,month[bx] 


;past end of month? 


jle 


month _ok 


;no, set the new date 


mov 


dl,i 


;yes; set day to 1 


inc 


dh 


;and increment month 


cmp 


dh,12 


;past end of year? 


jle 


month _ok 


;no, set the new date 


mov 


dh,l 


;yes, set the month to 1 


inc 


cx 


;increment year 


set_date cx,dh,dl 


;THIS FUNCTION 
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2BH 
Set Date 



Call AH = 2BH 

CX 

Year (1980-2099) 
DH 

Month (1-12) 
DL 

Day (1-31) 



Return AL 

OOH = Date was valid 
FFH = Date was invalid 



Remarks Registers CX and DX must contain a valid date 
in binary: 



CX Year (1980-2099) 

DH Month (1 = January, 2 = February, etc.) 
DL Day (1-31) 

If the date is valid, the date is set and AL 
returns 0. If the date is not valid, the function is 
canceled and AL returns FFH. 



Macro set_date macro year,month,day 

mov cx,year 
mov dh,moiith 
mov dl,day 
mov ah,2BH 
int 21H 
endm 
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2BH 
Set Date 



Example The following program gets the date, increments 

the day, increments the month or year, if neces- 
sary, and sets the new date: 



month 



db 



31,28,31,30,31,30,31,31,30,31,30,31 



func_2BH: 



month _ok: 



get_date 






;see Function 2AH 


inc 


dl 




;increment day 


xor 


bx,bx 




;so BL can be used as index 


mov 


bl,dh 




;move month to index register 


dec 


bx 




;month table starts with 


cmp 


dl,mon 


,th[bx] 


;past end of month? 


jle 


month 


_ok 


;no, set the new date 


mov 


dl,l 




;yes, set day to 1 


inc 


dh 




;and increment month 


cmp 


dh,12 




;past end of year? 


jle 


month 


_ok 


;no, set the new date 


mov 


dh,l 




;yes, set the month to 1 


inc 


cx 




;increment year 


set date cx,dh,dl 




;THIS FUNCTION 
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2CH 
Get Time 



Call 



AH = 2CH 



Return 



CH 

Hour (0-23) 
CL 

Minutes (0-59) 
DH 

Seconds (0-59) 
DL 

Hundredths (0-99) 



Remarks This function returns the current time set in the 
operating system as binary numbers in CX and 
DX: 

CH Hour (0-23) 

CL Minutes (0-59) 

DH Seconds (0-59) 

DL Hundredths of a second (0-99) 



Macro 



get_time macro 
mov ah,2CH 
int 21H 
endm 



Example The following program continuously displays 

the time until any key is pressed: 
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2CH 

Get Time 



time db "00:00:00.00", 13,"$" 

ten db 10 



func_2CH: 



get_time 

convert ch, ten, time 
convert cl,ten,time[3] 
convert dh,ten,time[6] 
convert dl,ten,time[9] 
display time 
check_kbd -Status 
cmp al,OFFH 
je all_done 
jmp func_2CH 



;THIS FUNCTION 
;see end of chapter 
;see end of chapter 
;see end of chapter 
;see end of chapter 
;see Function 09H 
;see Function OBH 
;has a key been pressed? 
;yes, terminate 
;no, display time 



all_done: 
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2DH 
Set Time 



Call AH = 2DH 

CH 

Hour (0-23) 
CL 

Minutes (0-59) 
DH 

Seconds (0-59) 
DL 

Hundredths (0-99) 



Return AL 

OOH = Time was valid 

FPH (255) = Time was invalid 



Remarks Registers CX and DX must contain a valid time 
in binary: 

CH Hour (0-23) 

CL Minutes (0-59) 

DH Seconds (0-59) 

DL Hundredths of a second (0-99) 

If the time is valid, the time is set and AL 
returns 0. If the time is not valid, the function is 
canceled and AL returns FFH (255). 



Macro set_time macro hour, minutes, seconds, hundredths 

mov ch,hour 

mov cl, minutes 

mov dh,seconds 

mov dl, hundredths 

mov ah,2DH 

int 21H 
endm 
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2DH 
Set Time 



Example The following program acts as a stopwatch. 

When a character is typed, it sets the system 
clock to zero and begins to continuously display 
the time. When a second character is typed the 
system stops updating the time display. 



time 
ten 



db 

db 



"00:00:00.00", 13,"$" 
10 



func_2DH: 



read_clock: 



dir_console_io OFFH 
jz func_2DH 
set -time 0,0,0,0 
get_time 

convert ch, ten, time 
convert cl,ten,time[3] 
convert dh,ten,time[6] 
convert dl,ten,time[9] 
display time 
dir_console_io OFFH 
jz read_clock 



;see Function 06H 
;wait for keystroke 
;THiS FUNCTION 
;see Function 2CH 
;see end of chapter 
;see end of chapter 
;see end of chapter 
;see end of chapter 
;see Function 09H 
;THIS FUNCTION 
;no char, keep updating 



continue: 
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2EH 

Set/Reset Verify Flag 



Return 
Remarks 



Macro 
Example 



AH = 2EH 
AL 

OOH = Do not verify 
OIH = Verify 



None 

AL must be either 1 (verify after each disk write) 
or (write without verifying). MS-DOS checks 
this flag each time it writes to a disk. 

The flag is normally off; you may wish to turn it 
on when writing critical data to disk. Because 
disk errors are rare and verification slows writ- 
ing, you will probably want to leave it off at 
other times. 



verify macro switch 
mov al, switch 
mov ah,2EH 
int 21H 



The following program copies the contents of a 
single-sided disk in drive A: to the disk in drive 
B:, verifying each write. It uses a buffer of 32K 
bytes: 



off 



on 



equ 
equ 



1 




prompt 



start 
buffer 



db 
db 
dw 
db 



"Source in A, target in B",13,10 

"Any key to start. $" 



64 dup (512 dup(?)) ;64 sectors 
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2EH 

Set/Reset Verify Flag 



func_2EH: display prompt 
read_kbd 
verify on 
mov cx,5 

copy: push cx 

abs_disk_read 0, buffer, 64, start 
abs -disk -write 1, buffer, 64, start 
add start, 64 

pop cx 
loojj copy 
verify off 



;see Function 09H 
;see Function 08H 
;THIS FUNCTION 
;copy 64 sectors 
;5 times 
;save counter 
;see Interrupt 25H 
;see Interrupt 26H 
;do next 64 sectors 
;restore counter 
;do it again 
;THIS FUNCTION 
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2FH 

Get Disk Transfer Address 



Call 



AH = 2FH 



Return 



ES:BX 

Points to Disk Transfer Address 



Macro 



get-dta macro 
mov 2h,2fh 
int 21h 
endm 



7-103 



30H 

Get DOS Version Number 



Call 



AH = 30H 



Return 



AL 

Major version number 
AH 

Minor version number 
BH 

OEM number 
BL:CX 

User number (24 bits) 



Remarks On return, AL.AH will be the two-part version 
designation; i.e., for MS-DOS 1.28, AL would be 
1 and AH would be 28. For pre-1.28 DOS AL = 0. 
Note that version 1.1 is the same as 1.10, not the 
same as 1.01. 



Macro 



get_version._num macro 
mov ah,30h 
.int 21h 
endm 



7-104 



31H 

Keep Process 



Call AH = 31H 

AL 

Exit code 
DX 

Memory size, in paragraphs 
Return None 



Remarks This call terminates the current process and 
attempts to set the initial allocation block to a 
specific size in paragraphs. It will not free up 
any other allocation blocks belonging to that 
process. The exit code passed in AX is retriev- 
able by the parent via Function 4DH. 

This method is preferred over Interrupt 27H and 
has the advantage of allowing more than 64K to 
be kept. 

Macro 

keep_process macro exitcode,parasize 
mov al,exitcode 
mov dx,parasize 
mov ah,31h 
int 21h 
endm 
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33H 

<CTRL C> Check 



Call 



AH = 33H 
AL 

Function 

OOH = Request current state 
OIH = Set state 
DL (if setting state) 
OOH = Off 
OIH = On 



Return 



DL 

OOH = Off 
OIH = On 



Remarks MS-DOS ordinarily checks for a CTRL C on the 
controlling device only when doing function call 
operations OIH-OCH to that device. Function 
33H allows the user to expand this checking to 
include any system call. For example, with the 
CTRL C trapping off, all disk I/O will proceed 
without interruption; with CTRL C trapping on, 
the CTRL C interrupt is given at the system call 
that initiates the disk operation. 



Note 



Programs that wish to use calls 06H or 07H to 
read CTRL C's as data must ensure that the 
CTRL C check is off. 



Error 
Returns 



AL = FF 

The function passed in AL was not in the range 
0:1. 
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33H 

<CTRL C> Check 



Macro 

ctrl_c_check macro switch, val 
mov dl,val 
mov al, switch 
mov ah,33h 
int 21h 
endm 
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35H 

Get Interrupt Vector 



Call AH = 35H 

AL 



Interrupt number 



Return ES:BX 

Pointer to interrupt routine 



Remarks This function returns the interrupt vector asso- 
ciated with an interrupt. Note that programs 
should never get an interrupt vector by reading 
the low memory vector table directly. 



Macro 



get_vector macro interrupt 
mov al, interrupt 
mov ah,35h 
int 21h 
endm 
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36H 

Get Disk Free Space 



Call AH = 36H 

DL 

Drive ( = Default, 1 = A, etc.) 



Return AX 

FFFF if drive number is invalid; otherwise 
sectors per cluster 
BX 

Available clusters 
CX 

Bytes per sector 
DX 

Clusters per drive 



Remarks This function returns free space on a disk along 
with additional information about the disk. 



Error AX = FFFF 

Returns 



The drive number given in DL was invalid. 



Macro 



get_disk_space macro drive 
mov dl, drive 
mov ah,36h 
int 21h 
endm 



38H 

Return Country-Dependent Information 



Call AH = 38H 

DS:DX 

Pointer to 32-byte memory area 
AL 

Function code. 



Return Carry set: 

AX 

2 = file not found 
Carry not set: 

DX:DS filled in with country data 



Remarks The value passed in AL is either (for current 
country) or a country code. Country codes are 
typically the international telephone prefix code 
for the country. 

If DX = -1, then the call sets the current country 
(as returned by the AL = call) to the country 
code in AL. If the country code is not found, the 
current country is not changed. 



Note Applications must assume 32 bytes of informa- 

tion. This means the buffer pointed to by DS:DX 
must be able to accommodate 32 bytes. 

This function is fully supported only in versions 
of MS-DOS 2.01 and higher. It exists in MS-DOS 
2.0, but is not fully implemented. 

This function returns, in the block of memory 
pointed to by DS:DX, information pertinent to 
international applications. The contents of the 
block are shown in the following table. 
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38H 

Return Country-Dependent Information 



WORD Date/time format 

5 BYTE ASCIIZ string 
currency symbol 

2 BYTE ASCIIZ string 
thousands separator 

2 BYTE ASCIIZ string 
decimal separator 

2 BYTE ASCIIZ string 
date separator 

2 BYTE ASCIIZ string 
time separator 

IBYTE Bitfield 

IBYTE 

Currency places 

IBYTE 
time format 

DWORD 

Case Mapping call 

2 BYTE ASCIIZ string 
data list separator 
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38H 

Return Country-Dependent Information 



The format of most of the entries is ASCIIZ (a 
NUL terminated ASCII string), but a fixed size 
is allocated for each field for easy indexing into 
the table. 

The date/time format (see table) has the follow- 
ing values: 

— USA standard h:m:s m/d/y 

1 — Europe standard h:m:s d/m/y 

2 — Japan standard y/m/d h:m:s 

The bit field contains 8 bit values. Any bit not 
currently defined must be assumed to have a 
random value. 

Bit = If currency symbol precedes the 
currency amount. 

= 1 If currency symbol comes after the 
currency amount. 

Bit 1 = If the currency symbol is directly 
adjacent to the currency amount. 

= 1 If there is a space between the 
currency symbol and the amount. 
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38H 

Return Country-Dependent Information 



The time format has the following values: 

0-12 hour time 
1 - 24 hour time 

The currency places field indicates the number 
of places which appear after the decimal point 
on currency amounts. 

The Case Mapping call is a FAR procedure 
which will perform country specific lower-to- 
uppercase mapping on character values from 
80H to FFH. It is called with the character to be 
mapped in AL. It returns the correct upper case 
code for that character, if any, in AL. AL and 
the FLAGS are the only registers altered. It is 
allowable to pass this routine codes below 80H; 
however nothing is done to characters in this 
range. In the case where there is no mapping, 
AL is not altered. 



Error AX 

Returns 2 = file not found 

The country passed in AL was not found (no 
table for specified country). 
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38H 

Return Country-Dependent Information 



Macro 

get_country_info macro buffer, country 
mov dx, offset buffer 
mov al,country ;country = 

mov ah,38h 
int 21h 
endm 
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39H 

Create Sub-Directory 



Call AH = 39H 

DS:DX 

Pointer to path name 



Return Carry set: 

AX 

3 = path not found 
5 = access denied 
Carry not set: 
No error 



Remarks Given a pointer to an ASCIIZ name, this func- 
tion creates a new directory entry at the end. 

Error AX 

Returns 3 = path not found 

The path specified was invahd or not 
found. 

5 = access denied 

The directory could not be created (no 
room in parent directory), the directory/ 
file already existed or a device name 
was specified. 



Macro 

mkdir macro name 
mov dx, offset name 
mov ah,39h 
int 21h 
endm 
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3AH 

Remove a Directory 



Call AH = 3AH 

DS:DX 

Pointer to path name 



Return Carry set: 

AX 

3 = path not found 
5 = access denied 

16 = current directory 
Carry not set: 

No error 



Remarks Function 3AH is given an ASCIIZ name of a 
directory. That directory is removed from its 
parent directory. 



Error AX 

Returns 3 = path not found 

The path specified was invahd or not 
found. 

5 = access denied 

The path specified was not empty, not a 
directory, the root directory, or contained 
invaUd information. 

16 = current directory 

The path specified was the current direc- 
tory on a drive. 



Macro 

rmdir macro name 
mov dx,offset name 
mov ah,3ah 
int 21h 
endm 



7-116 



3BH 

Change the Current Directory 



Call 



AH = 3BH 
DS:DX 

Pointer to path name 



Return 



Carry set: 
AX 

3 = path not found 
Carry not set: 
No error 



Remarks Function 3BH is given the ASCIIZ name of the 
directory which is to become the current direc- 
tory. If any member of the specified pathname 
does not exist, then the current directory is 
unchanged. Otherwise, the current directory is 
set to the string. 



Error 
Returns 



AX 



3 = path not found 

The path specified in DS:DX either indi- 
cated a file or the path was invaHd. 



Macro 



chdir macro name 
mov dx, offset name 
mov ah,3bh 
int 21h 
endm 
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3CH 

Create a File 



Call AH = 3CH 

DS:DX 

Pointer to path name 
CX 

File attribute 



Return Carry set: 

AX 

3 = path not found 

4 = too many open files 

5 = access denied 
Carry not set: 

AX is handle number 



Remarks Function 3CH creates a new file or truncates an 
old file to zero length in preparation for writing. 
DS:DX must point to an ASCIIZ path to the file. 
If the file did not exist, then the file is created in 
the appropriate directory and the file is given 
the attribute found in CX. The given attribute 
byte is placed at offset OBH in the file's directory 
entry. See the section on "Diskette Directory" in 
chapter 5 for details about the attribute byte. 
The file handle returned has been opened for 
read/ write access. 
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3CH 
Create a File 



Error AX 

Returns 3 = path not found 

The path specified was invahd. 

4 = too many open files 

5 = access denied 

The attributes specified in CX contained 
one that could not be created (directory, 
volume ID), a file already existed with a 
more inclusive set of attributes, or a direc- 
tory existed with the same name. 

The file was created with the specified attrib- 
utes, but there were no free handles available for 
the process, or the internal system tables were 
full. 



Macro 

create_file macro name,attrib 
mov dx, offset name 
mov cx,attrib 
mov ah,3ch 
int 21h 
endm 
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SDH 

Open a File Handle 



Call AH = SDH 

AL 
Access 

= file opened for reading 

1 = file opened for writing 

2 = file opened for both 

reading and writing 
DS:DX 

pointer to pathname 



Return Carry set: 

AX 

2 = file not found 

4 = too many open files 

5 = access denied 
12 = invalid access 

Carry not set 
AX is handle number 



Remarks Function 3DH associates a 16-bit handle with a 
file. 

The following values are allowed: 

ACCESS Function 

opened for reading 

1 opened for writing 

2 opened for both reading 
and writing. 

DS:DX point to an ASCIIZ name of the file to be 
opened. 

The read/ write pointer is set at the first byte of 
the file and the record size of the file is 1 byte. 
The returned file handle must be used for sub- 
sequent I/O to the file. 
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3DH 

Open a File Handle 



Error 
Returns 



AX 
2 = 



file not found 



The path specified was invalid or not 
found. 

4 = too many open files 

There were no free handles available in 
the current process or the internal system 
tables were full. 

5 = access denied 

The user attempted to open a directory or 
volume-id, or open a read-only file for writ- 
ing. 

12 = invalid access 

The access specified in AL was not in the 
range 0:2. 



open-handle macro name, access 
mov dx, offset name 
mov al, access 
mov ah,3dh 
int 21h 
endm 



Macro 
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3EH 

Close a File Handle 



Call 



AH = 3EH 
BX 

File handle 



Return 



Carry set: 
AX 

6 = invalid handle 
Carry not set: 
No error 



Remarks If BX is passed a file handle (like that returned 
by Functions 3CH, 3DH, or 45H), Function 3EH 
closes the associated file. Internal buffers are 
flushed to disk. 



Error AX 

Returns 6 = invalid handle 

The handle passed in BX was not currently 
open. 



Macro 



close_handle macro handle 
mov bx, handle 
mov ah,3eh 
int 21h 
endm 
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3FH 

Read From File/Device 



Call AH = 3FH 

DS:DX 

Pointer to buffer 
CX 

Bytes to read 
BX 

File handle 



Return Carry set: 

AX 

5 = error set: 

6 = invalid handle 
Carry not set: 

AX = number of bytes read 

Remarks Function 3FH transfers a specified number of 
bytes from a file into a buffer location. It is not 
guaranteed that the number of bytes requested 
will be read; for example, reading from the key- 
board will read at most one line of text. If the 
returned value is zero, then the program has 
tried to read from the end of file. 

All I/O is done using normalized pointers; no 
segment wraparound will occur. 



AX 

5 = access denied 

The handle passed in BX was opened in a 
mode that did not allow reading. 

6 = invalid handle 

The handle passed in BX was not cur- 
rently open. 



Error 
Returns 
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3FH 

Read From File/ Device 



Macro 

read_from_handle macro buffer,bytes, handle 

mov dx,offset buffer 

mov cx, bytes 

mov bx, handle 

mov ah,3fh 

int 21h 
endm 
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40H 

Write to a File or Device 



Call AH = 40H 

DS:DX 

Pointer to buffer 
CX 

Bytes to write 
BX 

File handle 



Return Carry set: 

AX 

5 = access denied 

6 = invalid handle 
Carry not set: 

AX = number of bytes written 



Remarks Function 40H transfers a specified number of 
bytes from a buffer into a file. It should be 
regarded as an error if the number of bytes writ- 
ten is not the same as the number requested. 

The write system call with a count of zero (CX = 
0) will set the file size to the current position. 
Allocation units are allocated or released as 
required. 

All I/O is done using normalized pointers; no 
segment wraparound will occur. 
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40H 

Write to a File or Device 



Error AX 

Returns 5 = access denied 

The handle was not opened in a mode that 
allowed writing. 

6 = invalid handle 

The handle passed in BX was not cur- 
rently open. 

Macro ; 

write_to -handle macro buffer, bytes, handle 
mov dx,offset buffer 
mov cx, bytes 
mov bx,handle 
mov ah,40h 
int 21h 
endm 
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41H 

Delete a Directory Entry 



Call AH = 41H 

DS:DX 



Pointer to path name 



Return Carry set: 

AX 

2 = file not found 
5 = access denied 
Carry not set: 
No error 



Remarks Function 41H deletes the file named in the 
ASCIIZ string pointed to by DS:DX. 



Error AX 

Returns 2 = file not found 

The path specified was invalid or not 
found. 

5 = access denied 

The path specified was a directory or read- 
only. 



Macro ; 

erase macro name 
mov dx,offset name 
mov ah,41h 
int 21h 
endm 
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42H 

Move File Pointer 



Call AH = 42H 

CX:DX 

Distance to move, in bytes 
AL 

Method of moving: 
(see text) 
BX 

File handle 



Return Carry set: 

AX 

1 = invalid function 
6 = invalid handle 
Carry not set: 

DX: AX = new pointer location 



Remarks Function 42H moves the read/ write pointer 
according to one of the following methods: 

Method Function 

the pointer is moved to offset bytes 
from the beginning of the file 

1 the pointer is moved to the current 
location plus offset 

2 the pointer is moved to the end of file 
plus offset 

Offset should be regarded as a 32-bit integer 
with CX occupying the most significant 16 bits. 



7-128 



42H 

Move File Pointer 



Error 
Returns 



AX 

1 = invalid function 



The function passed in AL was not in the 
range 0:2. 

6 = invalid handle 

The handle passed in BX was not cur- 
rently open. 



move_pointer macro highword,lowword,switch, 



mov dx,lowword 

mov cx, high word 

mov a 1, switch 

mov bx, handle 

mov ah,42h 

int 21h 
endm 



Macro 



handle 
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43H 

Change Attributes 



Call AH = 43H 

DS:DX 

Pointer to path name 
AL 

Function 

00 Return in CX 

01 Set to CX 
CX(if AL = 01) 

Attribute to be set 



Return Carry set: 

AX 

1 = invalid function 
3 = path not found 
5 = access denied 
Carry not set: 

CX attributes (if AL = 00) 



Remarks Given an ASCIIZ name pointed to by DS:DX, 
Function 42H will set/get the attributes of the 
file to those given in CX. See the section on 
"Diskette Directory" in chapter 5 for a descrip- 
tion of the attribute byte. 

A function code is passed in AL: 

AL Function 

return the attributes of the file in CX 

1 set the attributes of the file to those in CX 
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43H 



Change Attributes 



Error 
Returns 



AX 
1 = 



invalid function 



The function passed in AL was not in the 
range 0:1. 



The path specified was invahd. 

5 = access denied 

The attributes specified in CX contained 
one that could not be changed (directory, 
volume ID). 



change_attrib macro name, attrib, switch 



mov dx,offset name 
mov CX, attrib 
mov a 1, switch 
mov ah,43h 
int 21h 
endm 



3 = 



path not found 



Macro 
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44H 

I/O Control for Devices 



Call AH = 44H 

BX 

Handle 
BL 

Drive (for function codes 4 and 5; 

= default, 1 = A:, etc.) 
DS:DX 

Data or buffer 
CX 

Bytes to read or write 
AL 

Function code; see text 

Return Carry set: 

AX 

1 = invalid function 

5 = access denied 

6 = invalid handle 
13 = invalid data 

Carry not set: 
Function Code = 2,3,4,5 

AX = Count transferred 
Function Code = 6,7 

AL 

00 = Not ready 
FF = Ready 

Remarks Function 44H sets or gets device information 
associated with an open handle, or sends/ 
receives a control string to a device handle or 
device. 

The inputs to AL are function numbers, for 
which there are returns. The function number 
values and functions are discussed below. 

The following values are allowed in AL as func- 
tion codes: 
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44H 

I/O Control for Devices 



Call Function 

get device information (returned in DX) 

1 set device information (as determined 
by DX) 

2 read GX number of bytes into DS:DX 
from device control channel 

3 write CX number of bytes from DS:DX 
to device control channel 

4 read CX number of bytes into DS:DX 
from disk (drive number in BL) 

5 write CX number of bytes from DS:DX 
to disk (drive number in BL) 

6 get input status 

7 get output status 

This function can be used to get information 
about device channels. Calls can be made on 
regular files, but only calls 0,6 and 7 are defined 
in that case (AL = 0,6,7). All other calls return 
an invalid function error. 



Calls 0,1: The bits of DX are defined as follows for calls 
AL = and AL = 1. Note that the upper byte 
MUST be zero on a set call. 
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44H 

I/O Control for Devices 



15 14 13 12 11 10 9876543210 

R G I E R S I i i I 

eT SOAPSSSS 
s R Reserved DFWECNCC 

L E C L U O I 

V L K L T N 



ISDEV = 1 if this channel is a device 
= if this channel is a disk file 
(Bits 8-15 = in this case) 



If ISDEV = 1 



EOF = if End Of File on input 
RAW = 1 if this device is in Raw mode 

= if this device is cooked 
SPECL = 1 if this device is special 
ISCLK = 1 if this device is the clock device 
ISNUL = 1 if this device is the null device 
ISCOT = 1 if this device is the console output 
ISCIN = 1 if this device is the console input 



CTRL = if this device cannot do control strings 

via calls AL = 2 and AL = 3 

CTRL = 1 if this device can process control 

strings via calls AL = 2 and AL = 3. 

NOTE that this bit cannot be set. 



If ISDEV = 



EOF = if channel has been written 

Bits 0-5 are the block device number for the 

channel (0 = A:, 1 = B:, ...) 



7-134 



44H 

I/O Control for Devices 



NOTE: Bits 15,8-13,4 are reserved and should 
not be altered. 



Calls 2. .5: These four calls allow arbitrary control strings 
to be sent or received from a device. The call 
syntax is the same as the read and write system 
calls, except for 4 and 5, which take a drive 
number in BL instead of a handle in BX. 

An invalid function error is returned if the 
CTRL bit (see above) is 0. 

An access denied error is returned by calls AL = 
4,5 if the drive number is invalid. 



Calls 6,7: These two calls allow the user to check if a file 
handle is ready for input or output. Status of 
handles open to a device is the intended use of 
these calls, but status of a handle open to a disk 
file is allowed, and is defined as follows: 

For input: 

• Always ready (AL = FF) until EOF reached, 
then always not ready (AL = 0) unless current 
position changed via Function Request 42H 
(LSEEK). 

For output: 

• Always ready (even if disk full). 

The status is defined at the time the system is 
CALLED. On future versions, by the time con- 
trol is returned to the user from the system, the 
status returned may NOT correctly reflect the 
true current state of the device or file. 
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44H 

I/O Control for Devices 



Error AX 

Returns 1 = invalid function 

The function passed in AL was not in the 
range 0:7. 

5 = access denied (calls AL = 4,5) 

6 = invalid handle 

The handle passed in BX was not cur- 
rently open. 

13 = invalid data 



Macro ; 

io_ctrl_dev macro handle, buffer, bytes, switch 
mov bx,handle ;or 8-bit drive number 

mov dx, offset buffer 
mov cx,bytes 
mov al, switch 
mov 2h,44h 
int 21h 
endm 
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45H 

Duplicate a File Handle 



Call 



AH = 45H 
BX 

File handle 



Return 



Carry set: 
AX 

4 = too many open files 
6 = invalid handle 

Carry not set: 

AX = new file handle 



Remarks Function 45H takes an already opened file han- 
dle and returns a new handle that refers to the 
same file at the same position. 



Error AX 

Returns 4 = too many open files 

There were no firee handles available in 
the current process or the internal system 
tables were fiiU. 

6 = invalid handle 

The handle passed in BX was not cur- 
rently open. 



Example mov bx,fh 

mov ah,45H 
int 21H 
;ax has the returned handle 
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46H 

Force a Duplicate of a Handle 



Call 



AH = 46H 
BX 

Existing file handle 
CX 

New file handle 



Return 



Carry set: 
AX 

4 = too many open files 
6 = invalid handle 
Carry not set: 
No error 



Remarks Function 46H takes an already opened file han- 
dle and returns a new handle that refers to the 
same file at the same position. If there was 
already a file open on handle CX, it is closed 
first. 



Error AX 

Returns 4 = too many open files 

The internal system tables were full. 

6 = invalid handle 

The handle passed in BX was not cur- 
rently open. 



Example 



mov 
mov 
mov 
int 



bx,fh 
cx,newfh 
ah,46H 
21H 
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47H 

Return Name of Current Directory 



Call AH = 47H 

DS:SI 



Pointer to 64-byte memory area 
DL 

Drive number 



Return Carry set: 

AX 

15 = invalid drive 
Carry not set: 
No error 



Remarks Function 47H returns an ASCIIZ string giving 
the name of the current directory for a particular 
drive. The directory is root-relative and does not 
contain the drive specifier or leading path 
separator. The drive code passed in DL is = 
default, 1 = A:, 2 = B:, etc. 



Error AX 

Returns 15 = invahd drive 

The drive specified in DL was invalid. 



Macro 

duplicate_handle macro handle 
mov bx,handle 
mov ah,45h 
int 21h 
endm 
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48H 

Allocate Memory 



AH = 48H 
BX 

Size of memory to be allocated in paragraphs 



Garry set: 
AX 

7 = arena trashed 

8 = not enough memory 
BX 

Maximum size that could be allocated 
Carry not set: 
AX:0 

Pointer to the allocated memory 

Function 48H returns a pointer to a free block of 
memory that has the requested size in 
paragraphs. 

AX 

7 = arena trashed 

The internal consistency of the memory 
arena has been destroyed. This is due to a 
user program changing memory that does 
not belong to it, thus destroying the 
memory manager allocation marks. 

8 = not enough memory 

The largest available free block is smaller 
than that requested or there is no free 
block. 



7-140 



Call 



Return 



Remarks 



Error 
Returns 



48H 

Allocate Memory 



Macro 

force_handle macro old, new 
mov bx,old 
mov cx,new 
mov ah,46h 
int 21h 
endm 
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49H 

Free Allocated Memory 



Call 



AH = 49H 
ES 

Segment address of memory 
area to be freed 



Return 



Carry set: 
AX 

7 = arena trashed 
9 = invalid block 
Carry not set: 
No error 



Remarks Function 49H returns a piece of previously allo- 
cated memory to the system pool. 



Error AX 

Returns 7 = arena trashed 

The internal consistency of the memory 
arena has been destroyed. This is due to a 
user program changing memory that does 
not belong to it, thus destroying the 
memory manager allocation marks. 

9 = invalid block 

The block passed in ES is not one allo- 
cated via Function Request 48H. 



Macro 



cur_dir_nanie macro buffer, drive 
mov si, offset buffer 
mov dl, drive 
mov ah,47h 
int 21h 
endm 
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4AH 

Modify Allocated Memory Blocks 



Call 



AH = 4AH 
ES 

Segment address of memory area 
BX 

Requested memory area size 



Return 



Carry set: 
AX 

7 = arena trashed 

8 = not enough memory 

9 = invahd block 
BX 

Maximum size possible 
Carry not set: 
No error 



Remarks Function 4AH will attempt to grow/shrink an 
allocated block of memory. 



Error AX 

Returns 7 = arena trashed 

The internal consistency of the memory 
arena has been destroyed. This is due to a 
user program changing memory that does 
not belong to it, thus destroying the 
memory manager allocation marks. 

8 = not enough memory 

There was not enough free memory after 
the specified block to satisfy the grow 
request. 

9 = invalid block 

The block passed in ES is not one allo- 
cated via this function. 
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4AH 

Modify Allocated Memory Blocks 



Macro 

alloc_mem macro size 
mov bx,size 
mov ah,48h 
int 21h 
endm 
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4BH 

Load and Execute a Program (EXEC) 



AH = 4BH 
DS:DX 

Pointer to pathname 
ES:BX 

Pointer to parameter block 
AL 

00 = Load and execute program 
03 = Load program 



Carry set: 
AX 

1 = invalid function 

2 = file not found 

8 = not enough memory 

10 = bad environment 

11 = bad format 
Carry not set: 

No error 



Remarks This function allows a program to load another 
program into memory and optionally begin exe- 
cution of it. DS:DX points to the ASCIIZ name 
of the file to be loaded. ES:BX points to a 
parameter block for the load. 

A function code is passed in AL: 

AL Function 

load and execute the program. A pro- 
gram header is established for the pro- 
gram and the terminate and CTRL C 
addresses are set to the instruction after 
the EXEC system call. 

3 load (do not create) the program header, 
and do not begin execution. This is use- 
ful in loading program overlays. 



Call 



Return 
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4BH 

Load and Execute a Program (EXEC) 



For each value of AL, the block has the format 
shown in the following table. 

AL = - load/execute program 



WORD segment address of 
environment. 



DWORD pointer to command 

line at 80H of Program Segment Prefix 



DWORD pointer to default 
FCB to be passed at 5CH of PSP 



DWORD pointer to default 
FCB to be passed at 6CH of PSP 



AL = 3 - load overlay 



WORD segment address where 
file will be loaded. 



WORD relocation factor to 
be applied to the image. 



Note that all open files of a process are duplicat- 
ed in the child process after an EXEC. This is 
extremely powerful; the parent process has con- 
trol over the meanings of stdin, stdout, stderr, 
stdaux and stdprn. The parent could, for exam- 
ple, write a series of records to a file, open the 
file as standard input, open a Usting file as stan- 
dard output and then EXEC a sort program that 
takes its input from stdin and writes to stdout. 
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4BH 

Load and Execute a Program (EXEC) 



Also inherited (or passed from the parent) is an 
"environment." This is a block of text strings 
(less than 32K bytes total) that convey various 
configurations parameters. The format of the 
environment is as follows: 

(paragraph boundary) 



BYTE ASCIIZ string 1 



BYTE ASCIIZ string 2 



BYTE ASCIIZ string n 



BYTE of zero 



Typically the environment strings have the 
form: 

parameter = value 

For example, C0MMAND.COM might pass its 
execution search path as: 

PATH=A:\BIN;B:\BASIC\LIB 

A zero value of the environment address causes 
the child process to inherit the parent's envi- 
ronment unchanged. 
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4BH 

Load and Execute a Program (EXEC) 



Error 
Returns 



AX 

1 ■- 



invalid function 



The function passed in AL was not or 3. 
2 = file not found 

The path specified was invalid or not 
found. 

8 = not enough memory 

There was not enough memory for the 
process to be created. 

10 = bad environment 

The environment was larger than 32Kb. 

11 = bad format 

The file pointed to by DS:DX was in .EXE 
format and contained information that 
was internally inconsistent. 



free_memory macro address 
mov ax,address 
mov es,ax 
mov ah,49h 
int 21h 
endm 



Macro 
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4CH 

Terminate a Process 



Call AH = 4CH 

AL = Return code 

Return None 



Remarks Function 4CH terminates the current process 

and transfers control to the invoking process. In 
addition, a return code may be sent. All files 
open at the time are closed. 

This method is preferred over all others (Inter- 
rupt 20H, JMP 0) and has the advantage that 
CS:0 does not have to point to the Program 
Header Prefix. 

Macro 

modify_memory macro address, size 
mov ax,address 
mov es,ax 
mov bx,size 
mov ah,4ah 
int 21h 
endm 
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4DH 

Retrieve the Return Code of a Child 



Call 



AH = 4DH 



Return 



AX 

Exit code 



Remarks Function 4DH returns the Exit code specified by 
a child process. It returns this Exit code only 
once. The low byte of this code is that sent by 
the Exit routine. The high byte is one of the 
following: 

- Terminate/ abort 

1 - CTRL C 

2 - Hard error 

3 - Terminate and stay resident 



Macro 



exec macro path, param, switch 
mov dx,offset path 
mov bx, offset param 
mov a 1, switch 
mov ah,4bh 
int 21h 
endm 
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4EH 

Find Match File 



Call AH = 4EH 

DS:DX 

Pointer to pathname 
CX 

Search attributes 



Return Carry set: 

AX 

2 = file not found 
18 = no more files 
Carry not set: 
No error 



Remarks Function 4EH takes a pathname with wild card 
characters in the last component (passed in an 
ASCIIZ string pointed to by DS:DX) along with 
a set of attributes (passed in CX) and attempts 
to find all files that match the pathname and 
have a subset of the required attributes. A 
datablock at the current DTA is written that 
contains information in the following form: 



find_buf_reserved DB 21 DUP (?); Reserved* 



find_buf_attr 

find_buf^ime 

find_buf_date 

find_buf_size_l 

find_buf_size_h 

find_buf_pname 

find_buf ENDS 



DB ? ;attribute found 



DW? 
DW? 
DW ? 
DW? 



time 
date 
low(size) 
high(size) 



DB 13 DUP (?) ;packed name 



'Reserved for MS-DOS internal use on subsequent 
find_nexts 



To obtain the subsequent matches of the path- 
name, see the description of Function 4FH. 



7-151 



4EH 

Find Match File 



Error 
Returns 



AX 

2 = file not found 



The path specified in DS:DX was an 
invalid path. 

18 = no more files 

There were no files matching this specifi- 
cation. 



terminate_process macro code 
mov al,code 
mov ah,4ch 
int 21h 
endm 



Macro 
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4FH 

Step Through a Directory Matching 

Files 



Call 



AH = 4FH 



Return 



Carry set: 
AX 

18 = no more files 
Carry not set: 
No error 



Remarks The current DTA address must point at a block 
returned by Function 4EH (see Function 4EH). 



Error AX 

Returns 18 = no more files 

There are no more files matching this 
pattern. 



Macro 



retrieve_code macro 
mov ah,4dh 
int 21h 
endm 
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54H 

Return Current Setting of Verify 
After Write Flag 



Call 



AH = 54H 



Return 



AL 

Current verify flag value 



Remarks The current value of the verify flag is returned 
in AL. 



Macro 



find_match macro name,attrib 
mov dx,offset name 
mov cx,attrib 
mov ah,4eh 
int 21h 
endm 
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56H 

Move a Directory Entry 



Call 



AH = 56H 
DS:DX 

Pointer to pathname of 

existing file 
ES:DI 

Pointer to new pathname 



Return 



Carry set: 
AX 

2 = file not found 
5 = access denied 
17 = not same device 
Carry not set: 
No error 



Remarks Function 56H attempts to rename a file into 
another path. The paths must be on the same 
device. 



Error 
Returns 



AX 

2 = 



file not found 

The file name specifed by DS:DX was not 
found. 



5 = access denied 

The path specified in DS:DX was a direc- 
tory or the file specified by ES:DI already 
exists or the destination directory entry 
could not be created. 

17 = not same device 

The source and destination are on differ- 
ent drives. 
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56H 

Move a Directory Entry 



Macro 

step_inatch macro 
mov ah,4fh 
int 21h 
endm 
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57H 

Get/Set Date/Time of File 



Call AH = 57H 

AL 

00 = get date and time 

01 = set date and time 
BX 

File handle 
CX(if AL = 01) 

Time to be set 
DX(if AL = 01) 

Date to be set 

Return Carry set: 

AX 

1 = invalid function 
6 = invalid handle 

Carry not set: 

No error 

CX/DX set if function 



Remarks Function 57H returns or sets the last-write time 
for a handle. These times are not recorded until 
the file is closed. 

A function code is passed in AL: 

AL Function 

return the time/date of the handle in 
CX/DX 

1 set the time/date of the handle to 
CX/DX 

The format for the date and time is the same as 
the date and time fields for a directory entry, 
except that the individual bytes in each word are 
reversed. The high order portion of the time is in 
CL, and the high order portion of the date is in 
DL. 
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57H 

Get/Set Date/Time of File 



Error 
Returns 



AX 
1 = 



invalid function 



The function passed in AL was not in the 
range 0:1. 

6 = invalid handle 

The handle passed in BX was not cur- 
rently open. 



Macro 



check_verify_flag macro 



mov ah,54h 
int 21h 
endm 
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Macro 



Note 



These macro definitions apply to system call 
examples OOH through 57H. 



******************* 



Interrupts 



******************* 



;ABS_DISK_READ 
abs_disk_read macro disk, buffer, num_sectors, first_sector 
mov al,disk 
mov bx, offset buffer 
mov cx,num_sectors 
mov dx,first_sector 

int 25H ;interrupt 25H 



;ABS_DISK_WRITE 
abs_disk_write macro disk, buffer, num_sectors, first_sector 
mov al,disk 
mov bx,offset buffer 
mov cx,num_sectors 
mov dx, first-sector 

int 26H ;interrupt 26H 



stay_resident macro last_instruc ;STAY_RESIDENT 
mov dx, offset last_instruc 



popf 
endm 



popf 
endm 



int 

endm 



inc 



dx 
27H 



;interrupt 27H 



******************* 



Functions 



******************* 
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read_kbd_and_echo macro 
mov ah, 1 
int 21H 
endm 

display_char macro character 
mov dl, character 
mov ah, 2 
int 21H 
endm 

aux_input macro 
mov ah, 3 
int 21H 
endm 

aux_output macro 
mov ah,4 
int 21H 
endm 

print_char macro character 
mov dl, character 
mov ah, 5 
int 21H 
endm 

dir_console_io macro switch 
mov dl, switch 
mov ah, 6 
int 21H 
endm 

dir_console_input macro 
mov ah, 7 
int 21H 
endm 



;READ_KBD_AND_ECHO 
;function 1 

;DISPLAY_CHAR 
;function 2 

;AUX_INPUT 
;function 3 



;AUX_OUTPUT 
;function 4 

; PRINT-CHAR 

;function 5 

;DIR_CONSOLE_IO 
;function 6 

;DIR_CONSOLE_INPUT 
;function 7 



read_kbd macro ;READ_KBD 

mov ah, 8 ;f unction 8 
int 21H 
endm 



display macro string 
mov dx,offset string 
mov ah, 9 
int 21H 
endm 

get_string macro limit, string 
mov string, limit 

dx, offset string 
ah,OAH 
21H 



mov 
mov 
int 
endm 



;DISPLAY 
;function 9 

;GET_STRING 
;function OAH 



;CHEeK_KBD_STATUS 
;function OBH 



check_kbd_status macro 
mov ah,OBH 
int 21H 
endm 



flush_and_read_kbd macro switch ;FLUSH_AND_READ_KBD 
mov al, switch 

mov ah,OCH ;function OCH 

int 21H 

endm 



reset-disk macro 
mov ah,ODH 
int 21H 
endm 

select-disk macro disk 
mov dl,disk[-65] 
mov ah,OEH 
int 21H 
endm 

open macro fcb 

mov dx,offset fcb 
mov ah,OFH 
int 21H 
endm 



;RESET DISK 
;function ODH 



;SELECT-DISK 
;function OEH 

;OPEN 

/function OFH 
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close macro fcb 

mov dx,offset fcb 
mov ah,10H 
int 21H 
endm 

search_first macro fcb 
mov dx, offset fcb 
mov ah,llH 
int 21H 
endm 

search_next macro fcb 
mov dx, offset fcb 
mov ah,12H 
int 21H 
endm 

delete macro fcb 

mov dx,offset fcb 
mov ah,13H 
int 21H 
endm 

read_seq macro fcb 
mov dx,offset fcb 
mov ah,14H 
int 21H 
endm 

write_seq macro fcb 
mov dx,offset fcb 
mov ah,15H 
int 21H 
endm 

create macro fcb 

mov dx, offset fcb 
mov ah,16H 
int 21H 
endm 



;CLOSE 

;f unction lOH 

;SEARCH_FIRST 
;function IIH 

;SEARCH_NEXT 
;f unction 12H 

;DELETE 

;f unction 13H 

;READ_SEQ 
;function 14H 

;WRITE_SEQ 
;f unction 15H 

;CREATE 

;f unction 16H 
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rename macro special_fcb ;RENAME 
mov dx,offiset special_fcb 
mov ah,17H ;f unction 17H 

int 21H 
endm 



current—disk macro 
mov ah,19H 
int 21H 
endm 

set_dta macro buffer 

mov dx, offset buffer 
mov ah, 1 AH 
int 21H 
endm 

read_ran macro fcb 
mov dx, offset fcb 
niov ah,21H 
int 21H 
endm 

write_ran macro fcb 
mov dx, offset fcb 
mov ah,22H 
int 21H 
endm 

file_size macro fcb 
mov dx, offset fcb 
mov ah,23H 
int 21H 
endm 



;CURRENT_DISK 
;f unction 19H 

;SET_DTA 
;function lAH 

;READ_RAN 
;f unction 21H 

;WRITE_RAN 
;function 22H 

;FILE_SIZE 
;function 23H 
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set_relative_record. macro fcb 
mov dx, offset fcb 
mov ah,24H 
int 21H 
endm 



; SET_RELATI VE_RECORD 
;function 24H 



set_vector macro interrupt, seg_addr, of f_addr ; SET-VECTOR 
push ds 

ax,seg_addr 
ds,ax 

dx,off_addr 
al,interrupt 

ah,25H ;function 25H 

21H 



mov 
mov 
mov 
mov 
mov 
int 
endm 



ran_block_read macro fcb,couht,rec_size;RAN_BLOCK_READ 

mov dx,offset fcb 

mov cx,couiit 

mov word ptr fcb[14], rec_size 

mov ah,27H ;f unction 27H 

int 21H 

endm 



ran_block_write macro fcb, count, rec_size;RAN_BLOCK_WRITE 

mov dx, offset fcb 

mov cx, count 

inov word ptr fcb[14], rec_Size 

mov ah,28H ;f unction 28H 

int 21H 

endm 
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parse macro filename, fcb ;PARSE 



mov 


si, offset filename 




mov 


di,offset fcb 




push 


es 










pop 


es 




mov 


al,OFH 




mov 


ah,29H 


;function 29H 


int 


21H 




pop 


es 




eridm 






^ 1 V»l Cl LC7 




, OIL X —L>i\ 1 JCi 


mov 


ah, 2 AH 


;function 2AH 


int 


21H 




endm 






; 

set_date 


macro year, month, day- 


;SET_DATE 


mov 


ex, year 




mov 


dh, month 




liiov 


dl,day 




mov 


ah,2BH 


/function 2BH 


int 


21H 




endm 






get_time 


macro 


;GET_TIME 


mov 


ah,2CH 


/function 2CH 


int 


21H 




endm 










;SET_TIME 


set_time macro hour, minutes, seconds, hundredth 


mov 


ch,hour 




mov 


cl, minutes 




mov 


dh,seconds 




mov 


dl,hundredths 




mov 


ah,2DH 


/function 2DH 


int 


21H 





endm 
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verify macro switch 

mov al, switch 

mov ah,2EH 
int 21H 
endm 

get-dta macro 

mov ah,2FH 

iiit 21H 
endm 

get-version 
mov 
int 

endm 

keep_process 
mov 
mov 
mov 
int 

endm 

ctrl_c_check macro switch, val 



mov dl,val 

mov a 1, switch 

mov ah,33H 

int 21H 
endm 

get_vector macro interrupt 

mov al,interrupt 

mov ah,35H 

int 21H 
endm 

get_disk_space macro drive 

mov dl, drive 

mov 2h,36H 

int 21H 
endm 



_num macro 
ah,30H 
21H 



macro exitcode,parasize 
al,exitcode 
dx,parasize 
ah,31H 
21H 



;VERIFY 
;function 2EH 

;GET_DTA 

;GET_VERSION_NUM 
;KEEP_PROCESS 



;CTRL_C_CHECK 



;GET_VECTOR 
;GET_DISK -SPACE 



get_country_info macro buffer, country ;GET_COUNTRY_INFO 



mov dx, offset buffer 

mov a 1, country ;country = 

mov ah,38H 

int 21H 



endm 

mkdir macro 
mov 
mov 
int 

endm 

rmdir macro 
mov 
mov 
int 

endm 

chdir macro 
mov 
mov 
int 

endm 

create_file macro name,attrib ;CREATE_FILE 



mov dx, offset name 

mov cx,attrib 

mov ah,3CH 

int 21H 



endm 

open_handle 
mov 
mov 
mov 
int 

endm 



name ;MKDIR 
dx, offset name 
ah,39H 
21H 



name ;RMDIR 
dx, offset name 
ah, 3 AH 
21H 



name ;CHDIR 
dx,offset name 
ah,3BH 
21H 



macro name,access ;OPEN_HANDLE 
dx,offset name 
al, access 
2h,3DH 
21H 
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close-handle macro handle 
bx, handle 



;CLOSE_HANDLE 



mov 
mov 
int 

endm 



2h,3EH 
21H 



read -from -handle macro buffer, bytes, handle 

;READ-FROM_HANDLE 

dx, offset buffer 
cx, bytes 
bx, handle 
ah,3FH 
21H 



mov 
mov 
mov 
mov 
int 
endm 



write-to-handle macro buffer, bytes, handle 

;WRITE-TO_HANDLE 

dx, offset buffer 
cx, bytes 
bx, handle 
ah,40H 
21H 



mov 
mov 
mov 
mov 
int 
endm 



erase macro name 

mov dx, offset name 

mov ah,41H 
int 21H 
endm 



;ERASE 



move_pointer macro highword,lowword,switch,handle 

;MOVE -POINTER 

dx,lowword 
cx,highword 
a 1, switch 
bx, handle 
ah,42H 
21H 



mov 
mov 
mov 
mov 
mov 
int 
endm 
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change_attrib macro name, attrib, switch ;CHANGE_ATTRIB 

raov dx, offset name 

mov cx, attrib 

mov al,switch 

mov 2h,43H 

int 21H 
endm 



mov 
mov 
mov 
mov 
mov 
int 
endm 



;or 8-bit drive number 



io_ctrl_dev macro handle, buffer, bytes, switch 

;IO_CTRL_DEV 

bx, handle 
dx, offset buffer 
cx, bytes 
al, switch 
ah,44H 
21H 



duplicate_handle macro handle 
mov bx,handle 
mov ah,45H 
int 21H 
endm 



;DUPLICATE_HANDLE 



force_handle macro old, new 
mov bx,old 
mov cx,new 
mov ah,46H 
int 21H 
endm 



;FORCE_HANDLE 



cur_dir_name macro buffer,drive 
mov si,offset buffer 

mov dl, drive 

mov ah,47H 
int 21H 
endm 



;CUR_DIR_NAME 
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alloc_mem macro size ;ALLOC_MEM 
mov bx,size 
mov ah,48H 
int 21H 
endm 

free_memory macro address ;FREE_MEMORY 
mov ax,address 
mov es,ax 
mov ah,49H 
int 21H 
endm 

modify_memory macro address,size ;MODIFY_MEMORY 
mov ax,address 
mov es,ax 
mov bx,size 
mov ah, 4 AH 

int 21H 
endm 

exec macro path,param,switch ;EXEC 
mov dx,offset path 

mov bx, offset param 

mov al, switch 

mov ah,4BH 
int 21H 
endm 

terminate_process macro code ;TERMINATE_PROCESS 
mov al,code 
mov ah,4CH 
int 21H 
endm 

'retrieve_code macro ;RETRIEVE_CODE 
mov ah,4DH 
int 21H 
endm 
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find -match macro name,attrib 
niov dx, offset name 

mov cx,attrib 
mov ah,4EH 
int 21H 
endm 



;FIND_MATCH 



step_match macro 
mov ah,4FH 
int 21H 
endm 



;STEP_MATCH 



check _vefify_f lag macro 
mov ah,54H 
int 21H 
endm 



;GHECK_VERIFY_FLAG 



rename macro old,n(ew 

mdv dx, offset old 

mov di, offset new 

mov ah,56H 
int 21H 
endm 



;RENAME 



date_time_of_file macro switch,handle,date,time 

;DATE_TIME_OF_FILE 

a 1, switch 
bx, handle 
cx,time 
dx,date 
ah,57H 
21H 



mov 
mov 
mov 
mov 
mov 
int 
endm 
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General 



*********** 



move_string macro source, destination, num_bytes 

;MOVE_STRING 

push es 
mov ax, ds 

mov es,ax 
mov si,offset source 

mov di, offset destination 

mov cx,num_bytes 
rep movs es:destination,source 
pop es 
endm 



convert macro value, base, destination ;CONVERT 



table 
start: 



local 


table, start 


jmp 


start 


db 


"0123456789ABCDEF" 


mov 


al,value 


xor 


ah, ah 


xor 


bx,bx 


div 


base 


mov 


bl,al 


mov 


al,cs: table[bx] 


mov 


destination, al 


mov 


bl,ah 


mov 


al,cs: tabie[bx] 


mov 


destination[l],al 


endm 





convert_to_binary macro string, number, value 

;CONVERT_TO_BINARY 







ten, start, calc, mult, no. 




]mp 


bLciiX 


ten 


db 


10 


start: 


mov 


xr^ 1 n o (i 
V di LLC?, \J 




xor 


CX,CX 




mov 


v^l, IlU.m.£)6r 




xor 


Sl, SI 


calci 


xor 


ax,ax 




mov 


al,string[si] 




sub 


al,48 




cmp 


cx,2 




jl 


no_mult 




push 


CX 




dec 


CX 


mult: 


mul 


cs:ten 




loop 


mult 




pop 


CX 


no_mult: 


add 


value, ax 




inc 


si 




loop 


calc 




endm 





convert_date macro dir_entry 





mov 


dx,word ptr dir_entry[25] 




mov 


cl,5 




shr 


dl,cl 




mov 


dh,dir_entry[25] 




and 


dh,lfh 




xor 


cx,cx 




mov 


cl,dir_entry[26] 


shr 


cl,l 




add 


cx,1980 




endm 
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• Keyboard Handling 

• Printer Routines 

• Miscellaneous ROM BIOS 
Services 

• Bypassing the BIOS 

• CONFIG.SYS 
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Overview 



This chapter describes the ROM BIOS service 
routines that are provided to perform the more 
low-level functions that you may need in your 
assembly language programs. Because these are 
low-level routines, ,they provide more direct 
access to the hardware than the DOS routines. 
However, they do not provide some of the protec- 
tion and conveniences that the DOS routines 
give. Be sure to check the chapter on "System 
Calls" to make your choice between similar DOS 
and BIOS calls. 
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ROM BIOS 
Service 
Routines 

Conventions 



Access to the BIOS service routines is through 
the 8086 software interrupts. The routines are 
called with conventions that are very similar to 
the conventions for calling DOS routines. 

To issue a BIOS interrupt, use the Interrupt 
statement to select the desired interrupt: 

INT 1 IH 

Some interrupts, like Interrupt IIH (Equipment 
List), perform only one function. Others, like 
Interrupt 13H (Diskette Services), have several 
sub-functions that you can call. To select a sub- 
function, move the number of the sub-function 
into the AH register. 

This chapter describes the register usage for 
each of the BIOS service routines. It is usually 
wise to save all important registers before call- 
ing a BIOS service routine. 
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Interrupt Vector List 



Interrupt 
Number 
(Hex) 


Name 


5 


Print Screen 


10 


Video 


11 


Equipment Check 


1 o 


Determine Memory Size 


13 


Diskette 


14 


Communications 


16 


Keyboard 


17 


Printer 


19 


Bootstrap 
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ROM BIOS 
Service 
Routines 

Video Control 



Introduction The video controller on the standard AT&T Per- 
sonal Computer 6300 supports both monochrome 
and color monitors and produces text or graph- 
ics for both color and monochrpme. Interrupt 
lOH has the BIOS services to support all of these 
modes. This section describes the details that 
pertain to each major type of video access. 



Monochrome The monochrome text modes are mode — 
Text Mode 40x25 characters and mode 2 — 80x25 charac- 
ters. The monochrome text mode uses 32K start- 
ing at B8000H. For each screen position, there 
are two bytes in memory. The first byte is the 
ASCII code for the character to be displayed. 
The second byte is the "attribute" that specifies 
how the character is to be displayed. This 
attribute byte controls brightness, underlining, 
and blinking. 

The low order nybble of the attribute byte gov- 
erns the character being displayed according to 
the following table: 

Value Meaning 

Character is black 

1 Character is normal (white) 
intensity, underlined 

7 Character is normal (white) 
intensity 

F Character is high intensity white 

Any other value for the low nybble selects a par- 
ticular gray character intensity. 

The high order nybble of the attribute byte gov- 
erns the character background and blinking. A 
displayed character will blink if the high ordesr 
bit of its attribute byte is set. The remaining 
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three bits select the gray scale of the background 
— again, 000 is black and 111 is white. Note that 
inverse video can be obtained by forcing a black 
character on a white background, i.e. an attri- 
bute byte of 70H. 

The first two bytes in the display memory con- 
trol the character in the top left corner of the 
screen. The next two bytes control the character 
in the top row, in the second column position, 
and so on. 

At the end of each line, the display memory re- 
turns to the first column of the next line. There 
are no gaps in the display storage, and no bound- 
aries between one line and the next. 

Eight pages of memory are used to build up to 
eight separate screens. Only one page is active 
at any time, but you can switch the active page 
number and thereby display screens very 
rapidly. 

The display pages are numbered - 7 for 4Qx25 
mode and - 3 for 80x25 mode. Page starts at 
memory location B8000H. For 40 column mode, 
the pages occur at 2K intervals; for 80 column, 
at 4K intervals. A total of 32K of memory is 
used. 
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Color Text The color text modes are mode 1 — 40x25 color 
Modes mode and mode 3 — 80x25 color. 

Memory usage for the color text modes is similar 
to the method used for monochrome text. Two 
bytes of memory are used for each character 
position: the first is the ASCII code for the char- 
acter and the second is the attribute byte. The 
attribute byte specifies blinking, brightness, and 
color. 

The attribute bytes in color text mode operate 
much the same way as they do in monochrome 
text modes with two major differences: 

• Instead of bits 0-3 and 4-7 selecting the gray 
scale of the foreground and background, they 
select foreground and background colors accord- 
ing to the following chart: 

Bit 



d 


c 


b 


a 


Color 














Black 











1 


Blue 








1 





Green 








1 


1 


Cyan 





1 








Red 





1 





1 


Magenta 





1 


1 





Brown 





1 


1 


1 


White 


1 











Grey 


1 








1 


Lt. blue 


1 





1 





Lt. green 


1 





1 


1 


Lt. cyan 


1 


1 








Lt. red 


1 


1 





1 


Lt. magenta 


1 


1 


1 





Yellow 


1 


1 


1 


1 


High intensity white 
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Note that since background color is determined 
by a three-bit value, only the first eight colors 
apply to that field. 

• There is no underline attribute possible in color 
mode. As can be seen by the chart above, attri- 
bute settings that produce an underline in 
monochrome mode produce a blue character in 
color mode. 

The display memory maps to the character posi- 
tions exactly as it does in monochrome text 
mode. 



Color There is one color graphics mode: mode 4 — 

Graphics medium resolution (320x200) color graphics. For 

Mode any color display, you can use up to four colors. 

You select fi:om one of two "palettes," each of 
which provides three colors. You select a "back- 
ground" color to be used as the fourth color. 

Palette contains green, yellow, and red. 
Palette 1 contains cyan (light blue), magenta, 
and white. 

320 pixels can be displayed on each of 200 lines. 
Each line takes 80 bytes or 640 bits of display 
memory. Each color pixel use two bits of 
memory. Since two bits give you four possible 
combinations, for each pixel you specify either 
the background color or one of the three colors in 
the current palette. The leftmost pixels are 
represented by the high order bits in the byte. 
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Display memory for color graphics mode starts 
at location B8000H and is divided into four 8K 
blocks. Starting at B8000, the first 8000D bytes 
contain the pixel data for the even scan lines on 
page zero. That is, the first 80 bytes describe line 
0, the next 80H describe line 2, and so on 
through line 198. The odd lines are described in 
the 8K block starting at BAOOO. The same pat- 
tern is repeated for page one in the next 16K 
block, with the even lines starting at BCOOO and 
the odd lines starting at BEOOO. 



High Memory for high resolution 640x200 mono- 

Resolution chrome graphics is handled similarly to 320x200 
Monochrome color graphics. The only difference is that 
Graphics instead of memory containing two bits of color 

information per pixel, each pixel can only be on 
or off and is thus represented by one bit. In this 
way eight pixels can be represented in a byte 
instead of four, so that a scan line takes as 
many bytes as in color graphics mode even 
though it contains twice as many pixels. As in 
color graphics mode, the leftmost pixels are 
represented in the high order bits of each byte, 
line mapping is exactly as described above for 
color graphics mode. In high resolution mono- 
chrome graphics the background color is always 
black and the foreground color is chosen by bits 
0-3 of the color select register. 
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Super High 
Resolution 
Monochrome 
Graphics 



Super high resolution 640x400 monochrome 
graphics mode maps one bit per pixel with the 
leftmost pixel represented at the high end of the 
byte, just like high resolution 640x200 mode. 
Also like high resolution mode, super high mode 
maps onto a black background with a fore- 
ground color chosen by the color select register. 
The memory mapping, however, takes up all 
32K of display memory for a single page. 
Memory is broken up into four 8K segments, 
with each segment containing the data for every 
fourth scan line. Thus display memory looks like 
this: 



Memory 
location 


Contains pixels for line numbers 


B8000 


0, 4, 8, ... 396 


B9F3F 


Not used. 


BAOOO 


1, 5, 9, ... 397 


BBF3F 


Not used. 


BCOOO 


2, 6, 10, ... 398 


BDF3F 


Not used. 


BEOOO 


3, 7, 11, ... 399 


BFF3F 


Not used. 
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Set Mode Input: 
and Clear (AH) = 

Screen (AL) contains the CRT mode value 

Text Modes: 

(AL) = 40x25 monochrome 
(AL) = 1 40x25 color 
(AL) = 2 80x25 monochrome 
(AL) = 3 80x25 color 

Graphics modes: 

(AL) = 4 320x200(medium resolution), color 
(AL) = 5 320x200(medium resolution), 

monochrome 
(AL) = 6 640x200 black/white (high resolution) 
(AL) = 40H graphics 640x400 monochrome 

super high resolution 
(AL) = 48H graphics 640x400 monochrome 

tiny text (80x50 text) 

Set Cursor Input: 
Type (AH) = 1 

Low order 5 bits of (CH) = start line for cursor. 

Note 

Do not set the high bits of CH: unpredictable 
results will occur. 



Low order 5 bits of (CL) = end line for cursor. 



Set Cursor Input: 
Position (AH) = 2 

(DHjDL) = RoWjColumn (Position 0,0 is upper 
left.) 

(BH) = page number (must be for super-res 
graphics mode.) 
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Read 

Cursor 

Position 



Input: 
(AH) = 3 

(BH) = page number (must be for 
graphics mode.) 



super-res 



Output: 

(DHjDL) = row, column of current cursor 
(CH,CL) = current cursor start and end lines 



Read 
Light Pen 
Position 



Input: 
(AH) = 4 

Output: 

(AH) = light pen switch not triggered 
(AH) = 1 valid light pen value obtained: 

(DH,DL) = row, column of character 

light pen position 
(CH) = raster line (0-199) 
(BX) = pixel column (0-319 for medium 
resolution, 0-639 for high 
resolution.) 



Select 
Active 
Page 
Number 



Valid only for modes (0 - 6) 

Input: 
(AH) = 5 

(AL) = 0-15 for modes 0, 1 
= 0-7 for modes 2, 3 
= 0-1 for modes 4, 6 
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Scroll Active Input: 
Page up (AH) = 6 

(AL) = number of lines blanked at bottom of 
window by scrolling up. AL = means 
blank entire window. 
(CHjCL) = row, column of upper left corner of 
scroll 

(DH,DL) = row, column of lower right corner of 
scroll 

(BH) = attribute to be used on blank line(s). 



Scroll Active Input: 
Page Dov^rn (AH) = 7 

(AL) = number of lines blanked at top of 

window by scrolling down. AL = means 
blank entire window. 
(CH,CL) = row, column of upper left corner of 
scroll 

(DHjDL) = row, column of lower right corner of 
scroll 

(BH) = attribute to be used on blank line(s). 



Character The next three video services perform character 
Handling input/output for the CRT. If your program dis- 
plays characters to the screen while in graphics 
modes, the characters are formed from a charac- 
ter generator image that is maintained in the 
ROM. However, only the first 128 characters are 
encoded there. If you want to create your own 
characters, either for the purposes of doing 
character graphics or implementing a foreign 
language alphabet, you must set up a table of 
code points for 128 new characters and initialize 
the pointer at interrupt IF (address 0007CH) to 
point to the IK table. These codes can then be 
accessed by referring to characters 128-255. 
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When you write characters to the screen in text 
mode, if you send more characters to be written 
than will fit on one line, the extra characters 
automatically wrap around to the beginning to 
the next line. In graphics mode, the character 
handling routines only produce correct results 
for characters contained on the same row (con- 
tinuation to succeeding lines does not work.) 



Read 

Attribute or 
Character at 
Current 
Cursor 
Position 



Input: 
(AH) = 8 

(BH) = current display page 
Output: 

(AL) = character read 

(AH) = attribute of character read 



Write 

Attribute and 
Character at 
Current 
Cursor 
Position 



Input: 
(AH) = 9 

(BH) = current display page 
(CX) = count of characters to write 
(AL) - character to write 
(BL) = attribute of character (if text mode) 
= color of character (if graphics mode) 



Note 

If bit 7 of BL = 1, the color value is exclusive 
OR'd with the current contents of the dot. 



Write Input: 

Character (AH) = 

Only at (BH) = 

Current (CX) = 

Cursor (AL) = 
Position 



OAH 

current display page 
count of characters to write 
character to write 
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Set Color Input: 
Pallette (AH) = OBH 

(BH) = color palette ID (0-127) 

(BL) = color value to be used with that color ID 

Color ID = selects the background color (0-15) 
Color ID = 1 selects the palette to be used: 

= green/red/yellow 

1 = cyan/magenta/white 



Write Dot Input: 

(AH) = OCH 

(DX) = row number 

(CX) = column number 

(AL) = color value. If bit 7 of AL = 1, the color 
value is exclusive OR'd with the current 
contents of the dot. 



Read Dot Input: 

(AH) = ODH 

(DX) = row number 

(CX) = column number 

Output: 

(AL) = the dot read 
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Write This routine is used by the "TYPE" command 

Teletype and other DOS commands to display data on 

the screen. 

Input: 

(AH) = OEH 

(AL) = character to write 

(BL) = foreground color in graphics mode 

Note 

Screen width is controlled by previous mode set. 



Current Input: 
Video State (AH) = OFH 

Output: 

(AL) = current mode 

(AH) = number of character columns on screen 
(BH) = current active display page 
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Introduction Interrupt 13H is the BIOS routine for diskette 
services. There are six services provided by INT 
13H. 



Input (AH) = Reset Diskette System 

(AH) = 1 Read status of diskette system into AL 

(AH) = 2 Read sectors into memory 

(AH) = 3 Write sectors from memory to diskette 

(AH) = 4 Verify the specified sectors 

(AH) = 5 Format a track 

Additional settings for read, write, verify, and 
format: 

(DL) = drive number (0 - 3 allowed, value 
checked) 

(DH) = head number (0 - 1 allowed, value not 
checked) 

(CH) = track number (0-39 allowed, value not 
checked) 

Additional settings for read, write, and verify: 

(CL) = sector number (1-9, value not checked) 
(AL) = number of sectors (max = 9, value not 
checked) 

ES:BX = address of buffer (not required for 

verify) For the format operation, ES:BX 
points to the collection of address fields 
for the track. There must be one of these 
fields for every sector on the track. Each 
field has four bytes: 

Offset = track number 

1 = head number 

2 = sector number 

3 = number of bytes/ sector 

(00 = 128, 01 = 256, 02 = 512, 03 = 1024) 
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Output (AH) = Status of operation: 

01 bad command 

02 address mark not found 

03 write was requested on write-protected 
disk 

04 requested sector not found 

08 DMA overrun 

09 DMA transfer crossed a 64K boundary 

10 read data error detected by CRC 
20 diskette controller chip failed 
40 seek to desired track failed 

80 device timeout 

(CY) = successful operation 

(CY) = 1 unsuccessful operation (AH has details) 

For read, write, and verify these registers are 
preserved: DS, BX, DX, CH, and CL. 

(AL) = number of sectors read; this value may 
be incorrect if a timeout occurred. 

NOTE 

If an error is reported by the diskette, reset the 
diskette, then retry the operation. On read opera- 
tions, no motor start delay is taken, so your code 
should retry three times to make sure that a read 
error is not caused by motor start-up. 
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Introduction This set of routines performs serial, RS232C 

communications through the communications 
port. You should use a polling technique in your 
communications; this is not interrupt-driven 
I/O. All functions are accessed through BIOS 
interrupt 14H. 



Initialize the Input: 
Communica- (AH) = 

tions Port (DX) = selection of RS-232 channel (0 or 1) 
(AL) = parameters for initialization in the 
following form: 



7 6 5 
— Baud Rate — 

000 - 110 baud 

001 - 150 

010 - 300 

011 - 600 

100 - 1200 

101 - 2400 

110 - 4800 

111 -9600 



4 3 
— Parity — 

00 - None 

01 - Odd 
11 - Even 



2 

Stopbit 



1 
— Word length — 



0- 1 10-7 bits 

1- 2 11 -8 bits 



Output: 

Condition is set according to the same conven- 
tions as in "Get Comm Port Status" (see below). 
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Send Input: 

Character (AH) = 1 

(DX) = RS232 channel to be used (0 or 1) 
(AL) = the character to be sent. 

Output: 

(AL) is preserved. 

(AH) — if the operation was unsuccessful, bit 7 
is set. The other bits in (AH) are set as 
they are in "Get Comm Port Status" if 
the operation was successful. 

Receive Input: 
Character (AH) = 2 

(DX) = RS232 channel to be used (0 or 1) 



Output: 

(AL) = the received character. 

(AH) = status of operation, if (AH) = 0, the oper- 
ation was successful. If the high order bit 
of (AH) is set, a timeout error aborted the 
operation and the rest of (AH) can be 
ignored. Any other setting of (AH) indi- 
cates errors in the receive character 
operation. 
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Get Comm Input: 
Port Status (AH) = 3 

(DX) = RS232 channel to be used (0 or 1) 

Output 
(AX) = status: 
(AH) = line control status 
bit 7 = timeout 

bit 6 = transmission shift reg. empty 
bit 5 = transmission holding reg. empty 
bit 4 = break detect 
bit 3 = framing error 
bit 2 = pgirity error 
bit 1 = overrun error 
bit = data ready 
(AL) = modem status 

bit 7 = received line signal detect 

bit 6 = ringing detect 

bit 5 = data set ready 

bit 4 = clear to send 

bit 3 = delta receive line signal detect 

bit 2 = trailing edge ring detected 

bit 1 = delta data set ready 

bit = delta clear to send 
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Introduction Interrupt 16H provides the keyboard handling 
functions through three sub-functions. Most 
keys return two values: a scan code and a char- 
acter code. The scan code is the same as the key 
number (see diagram beloW), and the character 
code is the ASCII superset interpretation of the 
key (including coincident SHIFTs or CTRLs). 
Check the section on "DOS Interrupts and Func- 
tion Calls" to select either the BIOS keyboard 
routines or the DOS routines. 



Fl F2 ESC 1 2 3 4 5 6 7 



3C I 



03 04 05 06 07 



BCD 



F3 F4 'X| Q W E R T Y U I O P I{ 1) -J HOME t PGUP 



3D 



F5 F6 CTRL 

HE 

FT F8 

0H 

F9 FIO ALT 

43 44 



10 11 12 13 14 15 16 17 18 19 1A 1B 

A S D F G H J K L ; ". ' 



47 48 49 4A 



I ID I I I IE I I IF I I 20 I I 21 I I 22 | | 23 | | 24 | | 25 | | 26 | | 27 
t \ ZXCVBNM<>? 



t SC t END * PGDN + 



41 I I 42 I 2A II I 28 J | 2C | | 2D | | 2E | | 2F | [ 30 | | 31 | | 32 | | 33 | | 34 | | 35 | | | 36 | | | 37 | | 4E | | 4F | | 50 | | 51 

CAPS LOCK INS DEL 
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CHARACTER CODES 

ASCII Value Control ASCII Value 

Decimal Hex Character Character Decimal Hex Character 



AAA 

000 


AA 

00 


(null) 


MT TT 


032 


OA 

20 


(space) 


001 


01 




SOH 


033 


21 


t 

I 


002 


02 


9 


SIX 


034 


22 


?j 


003 


03 


T 


IIjIX 


035 


23 


# 


004 


04 




EOl 


036 


24 


$ 


005 


05 






037 


25 


% 


006 


06 


▲ 


ACK 


038 


26 


& 


007 


07 


(beep) 


BEL 


039 


27 




008 


rvo 

08 


u 


Bo 


040 


oo 

28 


/ 

( 


009 


09 


/J. T^X 

(tab) 


HI 


041 


29 


) 


010 


OA 


(line leed) 




042 


O A 

2A 




Oil 


ATI 

OB 


(home) 


VI 


043 


OT> 

2B 


+ 


012 


oc 


(lorm leed) 


FF 


044 


O/^ 

2C 


> 


013 


OD 


(carriage 


CR 


045 


2D 








return) 










014 


OE 


JJ 


CI /~\ 

so 


046 


2E 




Olo 


AT? 

Ur 


V" 




04 / 


zr 


/ 


016 


10 




DLE 


048 


30 





017 


11 




DCl 


049 


31 


1 


018 


12 




DC2 


050 


32 


2 


019 


13 


M 


DC3 


051 


33 


3 


f\or\ 
OZyj 


14 




DC4 


AKO 

Ooz 


o4 


4 


021 


15 


§ 


NAK 


053 


35 


5 


022 


16 




SYN 


054 


36 


6 


023 


17 


r 


ETB 


055 


37 


7 


024 


18 




CAN 


056 


38 


8 


025 


19 




EM 


057 


39 


9 


026 


lA 




SUB 


058 


3A 




027 


IB 




ESC 


059 


3B 


J 


028 


IC 


(cursor 


FS 


060 


3C 


< 






right) 










029 


ID 


(cursor left) GS 


061 


3D 




030 


IE 


(cursor up) 


RS 


062 


3E 


> 


031 


IF 


(cursor 


US 


063 


3F 


? 






down) 
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CHARACTER CODES (Cont'd) 



ASCII 


Value 




Control 


ASCII 


Value 




Decimal 


Hex 


Character 


Character 


Decimal 


Hex 


Character 


CiRA 


40 


fin) 




uyo 


DU 


© 


UKJO 




A 




0Q7 

VV 1 


<^i 

Dl 


a 




49 


TD 




no a 
uyo 


oz 


D 


r\R7 


4*^ 
'to 


n 




uyy 


DO 


c 


UDO 


44 


L> 




1 fin 


(?4 
D4 


a 










1 01 


DO 


e 




to 


r 




109 


RR 

DO 


1 




47 


fl 
Ur 




1 HQ 


R7 
D ( 


S 


079 


4R 


n 




1 n4 


DO 


u 
n 


07^ 


4Q 


T 

1 






Dy 


1 


074 


4A 


T 





1 o« 


DrV 


3 


07*^ 




XT 

IV 




1 07 


DD 


K 


07R 


4P 


T 




1 nft 

iUO 


DL/ 


1 


077 


tly 


IVl 




1 r\Q 
iuy 


DU 


m 


07R 


41^ 


TV 




1 1 


RF 
Dili 


n 


07Q 


4F 
tp 






111 


Dr 


o 


OftO 


p;o 


p 




119 


/u 


P 


Ofti 
Uc5± 


Oi 


n 




1 1 Q 
iiO 


71 


q 


089 


p;9 


xv 




114 


79 


r 


0»^ 


Ou 






1 1 
110 


7Q 


s 


Uo4 


04 


T 
1 




lie 
lib 


7/1 
/4 


I 


085 


55 


u 




117 


75 


U 


086 


56 


V 




118 


76 


V 


087 


57 


w 




119 


77 


w 


088 


58 


X 




120 


78 


X 


089 


59 


Y 




121 


79 


y 


090 


5A 


Z 




122 


7A 


z 


091 


5B 


[ 




123 


7B 


{ 


092 


5C 


\ 




124 


7C 


1 

1 


093 


5D 


] 




125 


7D 


} 


094 


5E 


A 




126 


7E 




095 


5F 






127 


7F 
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CHARACTER CODES (Cont'd) 

ASCII Value ASCII Value 

Decimal Hex Character Decimal Hex Character 



1 oo 

Izo 


80 


Q 

ii 


Izy 


81 




8z 


e 


iol 


QO 

83 


a 


162 


84 


a 


1 OQ 

loo 


OCT 

85 


a 


1 OA 

lo4 


8o 


a 


1 or; 
loo 


87 


<? 


1 oc 
Loo 


QQ 
OO 


A 

e 


1 on 
lo / 


on 
89 


e 


1 OCJ 

loo 


O A 

8A 


e 


1 oo 
loy 


8r> 


i' 


14(J 


8C 


1 


1 /( 1 
i4i 


oU 


1 


'i Act 




A 

A 


1 AO 


or 


A 


A A 

144 


90 




145 


91 




146 


92 


/€ 


147 


93 





148 


94 


b 


149 


95 


N 




150 


96 




151 


97 


u 


152 


98 


t 


153 


99 





154 


9A 


U 


155 


9B 




156 


9C 


£ 


157 


9D 




158 


9E 


Pt 


159 


9F 


/ 



160 


AO 


a 


161 


Al 


1 


162 


A2 


6 


163 


A3 


u 


164 


A4 


n 


165 


A5 


N 


166 


A6 


a 


167 


A7 


g 


168 


A8 




169 


A9 




170 


AA 




171 


AB 


1/2 


172 


AC 


1/4 


173 


AD 


i 


174 


AE 


« 


175 


AF 


» 


176 


BO 




177 


Bl 




178 


B2 




179 


B3 


1 


180 


B4 


H 


181 


B5 


H 


182 


B6 


HI 


183 


B7 


— n 


184 


B8 


=^ 


185 


B9 




186 


BA 


II 


187 


BB 




188 


BC 


=£1 


189 


BD 


_H 


190 


BE 


mJ 


191 


BF 


—\ 
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CHARACTER CODES (Cont'd) 

ASCII Value ASCII Value 

Decimal Hex Character Decimal Hex Character 



192 


CO 


L 


224 


EO 


a 


193 


CI 


_L 


225 


El 




194 


C2 


T 


226 


E2 


r 


195 


C3 


1- 


227 


E3 


TT 


196 


C4 


— 


228 


E4 


I 


197 


C5 


+ 


229 


E5 


a 


198 


C6 


1= 


230 


E6 


fj 


199 


C7 


II- 


231 


E7 


T 


200 


C8 




232 


E8 


Q 


201 


C9 


It 


233 


E9 


-e- 


202 


CA 


JJL 


234 


EA 





203 


CB 




235 


EB 


6 


204 


CC 


11= 


236 


EC 


oo 


205 


CD 





237 


ED 





206 


CE 


JL 

-ir 


238 


EE 


( 


207 


CF 




239 


EF 


n 


208 


DO 




240 


FO 




209 


Dl 




241 


Fl 


± 


210 


D2 


-n- 


242 


F2 


> 


211 


D3 


u_ 


243 


F3 


< 


212 


D4 


1= 


244 


F4 


r 


213 


D5 


F= 


245 


F5 


J 


214 


D6 


rr 


246 


F6 




215 


D7 


+ 


247 


F7 




216 


D8 


4= 


248 


F8 


o 


217 


D9 


J 


249 


F9 


• 


218 


DA 


r 


250 


FA 


• 


219 


DB 


■ 


251 


FB 




220 


DC 




252 


FC 


n 


221 


DD 


1 


253 


FD 


2 


222 


DE 


1 


254 


FE 


■ 


223 


DF 




255 


FF 


(blank) 
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Read Next Input: 
ASCII (AH) = 

Character 

Output: 

(AL) = character code 
(AH) = scan code 

Note 

This routine will not return execution to the call- 
ing program until it has a keystroke to report. 



Check if This routine is used to check to see if a keystroke 
Keystroke has been entered. Use this function if you want 
Available to continue processing whether or not a key has 
been pressed. 

Input: 
(AH) = 1 

Output: 

Z flag = 1 — no code available 
Z flag = — code is available 
If a character is available, it is stored in AX in 
the same format as for the "Read Next ASCII 
Character" call. However, the code also remains 
in the keyboard buffer, so that a "Read Next 
ASCII Character" call returns this character's 
code value again. 
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Get Current Input: 
Shift Status (AH) = 2 

Output: 

(AL) = current shift status 

Shift States 

Bit Subject matter Meaning, when bit is 1 



7 Insert state active 

6 Caps-Lock state active 

5 Num-Lock state active 

4 Scroll-Lock state active 

3 Alt shift key depressed 

2 Ctrl shift key depressed 

1 left-hand shift key depressed 

right-hand shift key depressed 
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This set of BIOS routines communicates with 
the printer through interrupt 17H. 

Print a Input: 

Character (AH) = 

(AL) = the character to be printed 
(DX) = printer port number (0-3) 

Output: 

(AH) = 1 if character not printed due to timeout. 
Otherwise, bits are set as they are in 
"Get Printer Status" call. 



Initialize Input: 
Printer Port (AH) = 1 

(DX) = printer port number (0-3) 

Output: 

(AH) = printer status (see below) 



Get Printer Input: 
Status (AH) = 2 

(DX) = printer port number (0-3) 

Output: 



Bit 


Meaning if Set (equal to 1) 


7 


not busy 


6 


acknowledge 


5 


out of paper 


4 


selected 


3 


I/O error 


2 


not used 


1 


not used 





timeout (set by software) 



If a printer is connected, lOH and 90H are 
healthy statuses. Otherwise 30H is healthy. 
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System If you issue issue interrupt 19H, the system 

Reset bootstraps itself in much the same way as it 

does with the Ctrl-Alt-Delete key sequence. The 
only difference is that Ctrl-Alt-Delete causes 
diagnostics to be run, whereas Interrupt 19H 
causes an immediate system load. 



Print To obtain a printed copy of what is on the 

Screen screen, issue a request for interrupt 5H. This 

produces exactly the same result as pressing the 
shift and PrtSc keys. This routine works in 
either text or graphics modes. Unrecognizable 
characters are printed as blanks. 



8-30 



ROM BIOS 
Service 
Routines 



Equipment 
List 



Determine 

Memory 

Size 



You can use this routine to obtain a list of the 
optional equipment attached to your system. 
Simply issue an interrupt IIH; no register set-up 
is necessary. Output (starting with the most sig- 
nificant bit of (AX)) is as follows: 

Bit Meaning 

AH 7-6 number of printer adapters (0-3) 
5 not used 

4 game adapter attached, or not 
3-1 number of communications 
adapters (0-7) 

not used 

AL 7-6 number of diskette drives minus 1, 
if bit is set. 
5-4 starting video mode: 

01 — graphics card display,40 
columns,b/w 

10 — graphics card 

display,80 columns,b/w 

11 — monochrome card display 
3-2 amount of memory on system 

board: 

00 — 16KB Base 

01 — 32KB Base 

10 — 48KB Base 

11 — 64KB Base 

1 not used 

diskettes are attached; refer to 
bits 7 and 6. 

Interrupt 12H gives the total amount of memory 
in the address space, up to a megabyte. No regis- 
ter set-up is required. The BIOS reads the 
switches on the system board and adds the 
amount of memory on a memory expansion 
board and returns the total in (AX). The amount 
of memory is expressed as the number of IK 
blocks. 
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This section explains how you can either replace 
one of the BIOS service routines with a program 
of your own or add a "front-end" so that you per- 
form some preprocessing immediately prior to 
using a particular BIOS routine. 

When the system is powered on, low memory is 
initialized with the addresses of all of the BIOS 
interrupt routines. To replace a BIOS routine, 
change the address in the interrupt table to the 
address of the code which you want to execute in 
place of the BIOS code. To perform preprocess- 
ing before handing execution on to the BIOS 
code: 

1 replace the address of the BIOS routine with the 
address of your program 

2 transfer execution to the BIOS routine at the end 
of your program. 

Be sure to use the "Set Vector" system call 
(Function Request 25H) to replace the BIOS rou- 
tine addresses instead of writing directly to low 
memory. 
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CONFIG.SYS 



The special file CONFIG.SYS is processed 
automatically when DOS starts. As with the 
batch file AUTOEXEC.BAT, this processing is 
automatic. DOS will simply look at the root 
directory to see if the file is there. 

CONFIG.SYS is a text file that can be edited by 
EDLIN or any other text editor that produces 
ASCII files. Five commands can be used in the 
CONFIG.SYS file. Each command changes a 
system parameter. 



® BREAK ON/OFF 

Changes the way DOS checks for a 
CTRL/BREAK 



• BUFFERS=xx 

Sets the number of data buffers that DOS uses. 



* DEVICE=[d:] [path] filename [.ext] 

Adds a nonstandard device driver to DOS. 



® FILES=xx 

Sets the number of files that can use ASCIIZ 
strings. 

• SHELL=[d:] [path] filename [.ext] [d:] [path] /P 

Specifies an alternate command processor. 



Break Normally, DOS checks for a CTRL/BREAK 

only when it is doing input or output. Some pro- 
grams do very little (if any) input or output for 
long periods of time. The BREAK ON command 
sets DOS to check for a CTRL/BREAK when 
any DOS function is called. 
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BREAK OFF resets the default so that DOS 
only checks for a CTRL/BREAK during input 
and output. This command can be used to over- 
ride a BREAK ON that was set by CONFIG.- 
SYS. 



Buffers The number of buffers has an effect on both the 

speed of disk I/O and available memory. A 
larger number of buffers allocates more memory 
to the system for operations. This is highly 
desirabla for systems with large amounts of 
RAM that will be used for database applica- 
tions. It is highly undesirable for systems with 
minimal RAM that do little work with disk files. 

The system default is BUFFERS=2, which is 
adequate for most purposes and requires only IK 
of RAM. If your system will be doing a signifi- 
cant amount of data handling, especially on a 
hard disk, BUFFERS=4 would improve access 
times at a cost of only IK of internal memory. 



Device When DOS is first started, it loads all of the 

standard device drivers for the keyboard, screen 
and so on. If your system requires a special 
device driver, this command tells DOS where to 
find it. The device driver will then be loaded as 
an extension to DOS. 

Device drivers are .COM files with a specific 
structure described in Chapter 9. The command 
DEVICE=ANSI.SYS causes DOS to replace the 
standard display and keyboard device drivers 
with the extended screen and keyboard support 
that the extended functions require. 
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If you wish to load several special device drivers, 
you must use a DEVICE command for each one. 



Files Opening a file with an ASCIIZ string eliminates 

the traditional direct handling of a File Control 
Block (FCB). DOS will handle all these things 
for you by creating and maintaining FCBs 
internally. To do this, it needs memory. Each file 
requires 39 bytes of memory. 

The FILES command sets aside memory for this 
operation. The default is FILES=8. The maxi- 
mum is FILES=99. This is the limit for the 
entire system. A particular process (or program) 
can still have only 20 files open at once. 



Shell The C0MMAND.COM file that DOS uses as its 

"front end" processor can be replaced by another 
command processor. The SHELL command spec- 
ifies the file to be used and the default path for 
processing commands. The command processor 
must be able to read and execute commands, 
and handle interrupts 22H, 23H, and 24H. 

Since C0MMAND.COM handles internal com- 
mands, .BAT file execution, and .EXE file load- 
ing, these functions will be unavailable unless 
the new command processor duplicates them. 
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• Programmable Interrupt 
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• Programmable Interval Timer 
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Controller 
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Interested This section contains information on how to 
Audience write device drivers. You may not use it often 
since many input and output capabihties are 
implemented by the BIOS routines discussed in 
Section 6. BIOS routines allow you to do general 
input and output without a detailed understand- 
ing of the hardware and shield your program 
from hardware changes. 

However, there are times when BIOS routines do 
not perform the necessary function or do so in 
an inefficient fashion. Then your own driver is 
necessary. Implementation of operating sys- 
tems, of high speed graphics packages, and of 
unusual keyboard mapping are examples of 
software which require specialized drivers. 



Pro- This is a list of pr 

grammable 

Devices INS 8350B 

INTEL 8237A 

NECE UPD765 

DTC 5150BX 

INTEL 8041 

INTEL 8259A 

INTEL 8253 

58174A 
AMD Z8530 



HD 6845 



•grammable devices. 

Asynchronous Communications 

Element 

DMA Controller 

Floppy Diskette Controller 

Hard Disk Controller 

Keyboard Interface 

Programmable Interrupt 

Controller 

Programmable Interval Timer 
Real Time Clock and Calendar 
Serial Communications 
Controller 
Speaker Interface 
Video Controller 
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A port is a place to read or write information to 
an 1/ O device. An I/O device is hardware which 
the CPU controls. It is both input and output 
peripherals as well as hardware such as the 
DMA controller, the Interrupt controller and the 
Interval Timer. Each device needs different 
information, but they all need some combination 
of control, status, and data. 

Each port has an address. Sixteen of the twenty 
possible address lines are available for I/O 
addressing. This means there are 65,535 possible 
port addresses. 



1/ O IN and OUT instructions distinguish an I/O 

Instructions access from a memory access. These instructions 

translate into control signals which define the 

direction and path of the data. 

The port address can be specified in one of two 
ways — fixed or variable. In the fixed method, 
the absolute port address is specified in the 
instruction. The following instruction is an 
example of fixed port addressing: 

OUT 020H, AL 

Only 8-bit port addresses can be used in this 
format. 

The variable method allows 16-bit port 
addresses to be specified. In this case, the port 
address is loaded into the DX register and then 
the DX register is used in the I/O instruction. 
An example of variable port addressing follows: 

MOV DX,03F2H 
OUT DX,AL 



Port 

Addresses 
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Interrupts External devices do not need the CPU's atten- 
tion all the time. When they need servicing, they 
ask for it either by interrupting or by setting a 
polled flag. External interrupts are ignored 
when the CLI instruction has cleared the inter- 
rupt enable flag and are recognized when the 
STI instruction has set the flag. 

The first 1024 bytes of memory contain an inter- 
rupt table. This table has 255 interrupt pointers 
defining the start address of interrupt service 
routines. This is the pointer format. 

INTERRUPT POINTER 



IP 

cs 



When the CPU recognizes the interrupt, an 8-bit 
interrupt type identifies the device. The interrupt 
type is an index into the table of pointers. To 
obtain the interrupt pointer address, the type is 
multiplied by four. The CPU saves the flag reg- 
ister on the stack, disables interrupts and single 
step mode, and saves the CS and IP registers on 
the stack. Then the interrupt pointer is loaded 
into IP and CS, and control is transferred to the 
interrupt service routine. The stack looks like 
this when the service routine gets control. 
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Interrupt 
Devices 



SYSTEM STACK 



IP 



cs 



FLAGS 



When the service routine begins, interrupts are 
disabled. Depending on the nature of the appH- 
cation, interrupts can be enabled immediately or 
just prior to releasing control. 



The service routine must preserve the value of 
all internal registers. Therefore it saves the reg- 
isters it uses on the stack. Before returning, it 
restores these registers from the stack. 

To return control to the interrupt program, the 
service routine executes IRET. All the informa- 
tion necessary to do this was carefully placed on 
the stack 



Interrupt 
Devices 



INS 


8250B 


Asynchronous Communi- 






cations Element 


INTEL 


8237A 


DMA Controller 


NEC 


UPD765 


Floppy Diskette Controller 


DTC 


5150BX 


Hard Disk Controller 


INTEL 


8041 


Keyboard Interface 


INTEL 


8259A 


Programmable Interrupt 






Controller 


INTEL 


8253 


Programmable Interval 






Timer 




58174A 


Real Time Clock and 






Calendar 


AMD 


Z8530 


Serial Communications 






Controller 
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Block diagrams are a pictorial description of the 
electrical connection between the CPU, the inter- 
face, and the external device. In general, the 
CPU's bus signals appear on the left. The mid- 
dle of the diagram describes the internals of the 
interface. The right side of the diagram de- 
scribes the electrical interface. This physically 
connects the interface to the external device. The 
connection is often through a dual inline pack- 
age (DIP) of pins. Each pin carries one signal. 

Individual signals are represented by lines. 
Busses are shown as double lines. Each of these 
have arrows which indicate the direction of the 
data. Often they are bidirectional. 

There are several common CPU control bus sig- 
nals. There mnemonics and definitions follow: 

• A0-A19 

These are the lines used to transmit the address 
of memory or the address of an I/O port. Only 
A0-A15 are used for I/O addressing. 

• CS 

This signal selects the chip. No reading or writ- 
ing will occur unless the device is selected. 

• D0-D7 

These are the bidirectional data lines used to 
exchange information with a memory location 
or an I/O port. D7 is the most significant bit. 

• INT0-INT7 

These are the priority interrupt request lines. See 
the description of the Interrupt Controller. 



Block 
Diagrams 
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• lORD 

This signal indicates that an input port address 
has been placed on the address bus. The data at 
the specified port is to be placed on the data bus. 

• lOWR 

This signal indicates that an output port 
address has been placed on the address bus and 
the data has been placed on the data bus to be 
output to the specified port. 

• RESET 

This signal resets the system to a predetermined 
state. 
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What Is A device driver is binary code which manipu- 

a Device lates hardware in the MS-DOS environment. A 

Driver? special header at the beginning identifies it as a 

driver, defines the strategy and interrupt entry 
points, and describes various attributes of the 
device. The file must have an origin of zero. 

There are two kinds of devices: 

• Character devices 

• Block devices 

Character devices perform serial character 1/ O 
like CONSOLE, AUXILIARY, and PRINTER. 
These devices are named and users open chan- 
nels to do I/O to them. 

Block devices are the disk drivers on the system. 
They perform random I/O in pieces called 
blocks. This is usually the physical sector size. 
These devices are not named as the character 
devices are, and cannot be opened directly. 
Instead they are identified by drive letters 
(A:,B:,C:, etc.). 

Drive letters are assigned to device drivers based 
on their ordering in the CONFIG.SYS file. Start- 
ing with the letter 'A', each device driver is 
assigned as many consecutive alphabetic char- 
acters as the driver has units. The theoretical 
limit is 63, but after 26 the drive letters are non- 
alphabetic (such as ] and ^ ). 

Character devices cannot define multiple units 
because they have only one name. 
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Device A device header is required at the beginning of a 

Headers device driver. A device header looks hke this: 



DWORD pointer to next device 
(Must be set to -1) 



WORD attributes 

Bit 15 = 1 if char device, if blk 

ifbitlSisl 

Bit = 1 if current sti device 
Bit 1 = 1 if current sto device 
Bit 2 = 1 if current NUL device 
Bit 3 = 1 if current CLOCK dev 
Bit 4 = 1 if special 
Bits 5-12 Reserved; must be set 
toO 

Bit 14 is the lOCTL bit 

Bit 13 is the NON IBM FORMAT bit 



WORD pointer to device strategy 
entry point 



WORD pointer to device interrupt 
entry point 



8-BYTE character device name field 
Character devices set a device name. 
For block devices the first byte is 
the number of units 



The strategy and interrupt routines are in the 
same segment as this device header. 
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Pointer to The pointer to the next device header field is a 
Next Device double word field, offset followed by segment. 
Field MS-DOS chains the device headers together 

using this field. If you have a single device 
header in your driver, initialize this field to -1. If 
you have more than one device header, the first 
word of the double word pointer is the offset of 
the next driver's Device Header. 



Attribute The attribute field is used to tell the system 
Field whether this device is a block or character 

device (Bit 15). Most other bits are used to give 
selected character devices special treatment and 
are meaningless on a block device. For example, 
assume that you have a new standard input and 
output device driver. Besides installing the 
driver, you must tell MS-DOS that you want this 
new driver to override the current standard 
input and standard output device. This is 
accomplished by setting the attributes to the 
desired characteristics, so you set Bits and 1 to 
1. Similarly, a new CLOCK device could be 
installed by setting the appropriate attribute. 
Although there is a NUL device attribute, it is 
reserved for MS-DOS. 

The NON PC-DOS FORMAT bit applies only to 
block devices and affects the operation of the 
BUILD BPB (Bios Parameter Block) device call. 
The implementation of all block devices is PC- 
DOS software and hardware compatible. 

The lOCTL bit is meaningful for both types of 
devices. This bit tells MS-DOS whether the 
device can handle control strings with the 
lOCTL system call. Function 44H. 
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If a driver cannot process control strings, this 
bit is 0. MS-DOS returns an error if an attempt 
is made to handle control strings. A device 
which can process control strings sets the 
lOCTL bit to 1. For drivers of this type, MS-DOS 
calls lOCTL INPUT and OUTPUT device func- 
tions to send and receive lOCTL strings. 

The lOCTL functions allow data outside of the 
normal user's reads and writes to be sent to the 
driver. The interpretation of this information is 
up to the driver. 



Strategy and These two fields are the entry points of the strat- 
Interrupt egy and interrupt routines. They are word values 
Routines and they must be in the same segment as the 

Device Header. 



Name Field This 8-byte field contains the name of a charac- 
ter device or the number of units of a block 
device. If it is a block device, the number of units 
can be put in the first byte. This is optional 
because MS-DOS fills in this location with the 
value returned by the driver's INIT code. 



How to To create a device driver, write a binary file with 

Create a a Device Header at the beginning of the file. The 

Device code originates at 0. 
Driver 
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MS-DOS always processes installable device 
drivers before handling the default devices. To 
install a new CON device, simply name the 
device CON. Remember to set the standard 
input device and standard output device bits in 
the attribute word on the new CON device. The 
scan of the device list stops on the first match, 
so the installable device driver takes precedence, 

MS-DOS installs the driver anywhere in 
memory; therefore, be careful with memory ref- 
erences. Do not expect the driver to be loaded in 
the same place. 



Installation MS-DOS allows new device drivers to be 
of Device installed dynamically at boot time. This is 
Drivers accomplished by INIT code in the BIOS which 

processes the CONFIG.SYS file. 

At load time, DOS searches the root directory for 
a file named CONFIG.SYS. Declare the files 
containing your device drivers using the 
DEVICE command. 

DEVICE = [C:] [path] filename [.ext] 

DOS loads your drivers as an extension of itself. 
Include a separate DEVICE command for each 
driver to be loaded. 
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When MS-DOS calls a device driver to perform a 
function, it passes a Request Header in ES:BX to 
the strategy entry point. This is a fixed length 
header followed by data pertinent to the opera- 
tion being performed. It is the device driver's 
responsibility to preserve the machine state. For 
example, save all registers on entry and restore 
them on exit. There is enough room on the stack 
when strategy or interrupt is called to do about 
20 pushes. If more stack is needed, the driver 
sets up its own stack. 

The following figure illustrates a Request 
Header. 

REQUEST HEADER -> 

BYTE length of record (the 
length in bytes of perti- 
nent data, plus the length 
of this Request Header) 



BYTE unit code 

The subunit the operation 

is for (minor device) 

(no meaning on character 

devices) 



BYTE command code 



WORD status 



8 bytes RESERVED 



Unit Code If your device driver has three units, then the 
possible values of the unit code field are 0, 1, 
and 2. 



Request 
Header 
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Command The command code field in the Request Header 
Code Field can have the following values: 



Command 




Code 


Function 





INIT 


1 


MEDIA CHECK 




(Block only, NOP for character) 


2 


BUILD BPB 


3 


lOCTL INPUT 




(Only called if device has lOCTL) 


4 


INPUT (Read) 


5 


NON-DESTRUCTIVE INPUT NO WAIT 




(Char devices only) 


6 


INPUT STATUS 


7 


INPUT FLUSH 


8 


OUTPUT (Write) 


9 


OUTPUT (Write) with verify 


10 


OUTPUT STATUS 


11 


OUTPUT FLUSH 


12 


lOCTL OUTPUT 




(Only called if device has lOCTL) 



Status Word The following figure illustrates the status word 
in the Request Header. 



15 


14 13 12 11 10 
1 1 1 1 


9 


8 


76543210 

— 1 — »— »— H — 1 — 1 — 1— 


E 




B 


D 




R 


RESERVED 


U 





ERROR CODE 


R 


1 1 I 1 


S 


N 


(bit 15 on) 



The status word is set by the driver interrupt 
routine. 

Bit 8 is the done bit. When set, it means the 
operation is complete. 
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Bit 15 is the error bit. If it is set, then the low 8 
bits indicate the error. The errors are: 






Write protect violation 


1 


Unknown Unit 


2 


Drive not ready 


3 


Unknown command 


4 


CRC error 


5 


Bad drive request structure length 


6 


Seek error 


7 


Unknown media 


8 


Sector not found 


9 


Printer out of paper 


A 


Write fault 


B 


Read Fault 


C 


General failure 



Bit 9 is the busy bit which is set only by status 
calls. 

• For output on character devices: 

If bit 9 is 1 on return, a write request waits for 
completion of a current request. If it is 0, there is 
no current request and a write request starts 
immediately. 

• For input on character devices with a buffer: 

If bit 9 is 1 on return, a read request goes to the 
physical device. If it is on return, then there 
are characters in the device buffer and a read 
returns quickly. MS-DOS assumes all character 
devices have an input type-ahead buffer. Devices 
that do not have a type-ahead buffer return 
busy=0 so that MS-DOS does not wait for non- 
existent buffer input. 
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Media Check MEDIA CHECK and BUILD BPB are used with 
and Build block devices only. MS-DOS calls MEDIA 
BPB CHECK first for a drive unit and passes its cur- 

rent media descriptor byte. MEDIA CHECK 
returns one of the following results: 



Media Not Changed — current DPB and media 
byte are OK. 

Media Changed — Current DPB and media are 
wrong. MS-DOS invalidates buffers for this unit 
and calls the device driver to build the BPB. 



• Not Sure — If there are dirty buffers for this 
unit, MS-DOS assumes the DPB and media byte 
are OK. If nothing is dirty, MS-DOS assumes 
the media has changed. It invalidates buffers for 
the unit and calls the device driver to build the 
BPB. 



• Error — If an error occurs, MS-DOS sets the 
error code. 



MS-DOS calls BUILD BPB under the following 
conditions: 



If Media Changed is returned 

If Not Sure is returned and there are no dirty 
buffers 



Init Routine The Init Routine is called only once when the 
device is installed. It returns a location DS:DX 
which is a pointer to the first free byte of 
memory after the device driver. To save space, 
this pointer method can be used to delete initial- 
ization code that is only used once. 
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Additional information that block drivers return 
is: 

• The number of units 

• A pointer to a BPB 

• The media decriptor 

The number of units determines the logical 
device names. This mapping is determined by 
the position of the driver in the device list and 
by the number of units on the device. 

BPB blocks are used to build an internal MS- 
DOS data structure for each of the units. The 
driver passes MS-DOS a pointer to an array of n 
word BPB pointers, where n is the number of 
units. If all units are the same, they can share a 
BPB to save space. This array must be before 
the free space pointer since MS-DOS builds an 
internal DOS structure starting at this free byte. 
The defined sector size must be less than or 
equal to the maximum sector size defined at 
INIT time; otherwise, the install fails. 

The media descriptor byte means nothing to MS- 
DOS. It is passed to drivers so that they know 
what parameters MS-DOS is currently using for 
a drive unit. 

Block devices are either dumb or smart. A dumb 
device defines a unit and an internal DOS struc- 
ture for each possible media drive combination. 
For example, unit = drive single side, unit 1 = 
drive double side. In this case, media descrip- 
tor bytes mean nothing. 
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A smart device allows multiple media per unit. 
In this case, the BPB table returned by INIT 
defines space large enough to accommodate the 
largest possible media supported. Smart drivers 
use the media descriptor byte to pass informa- 
tion about the media currently in a unit. 



Function Strategy routines are called with ES:BX point- 

Call ing to the Request Header. The interrupt rou- 

Parameters tines get the pointers to the Request Header 

from the queue that the strategy routines store 
them in. The command code in the Request 
Header tells the driver which function to 
perform. 

All DWORD pointers are stored offset first, then 
segment. 

INIT 

Command code = 

INIT - ES:BX -> 



13-BYTE Request Header 

BYTE # of units 

DWORD break address 

DWORD pointer to BPB array 
(Not set by character devices) 



The number of units, break address, and BPB 
pointer are set by the driver. On entry, the 
DWORD points to the character after the '=' on 
the line in CONFIG.SYS. This allows drivers to 
scan the CONFIG.SYS invocation line for 
arguments. 
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If there are multiple device drivers in a single 
.COM file, the ending address returned by the 
last INIT is the one MS-DOS uses. All of the 
device drivers in a single .COM file return the 
same ending address. 



Media Check Command Code = 1 

MEDIA CHECK - ES:BX -> 



13-BYTE Request Header 
BYTE media descriptor from DPB 
BYTE returned 



In addition to setting the status word, the driver 
sets the return byte to one of the following: 

-1 Media has been changed 

Don't know if media has been changed 

1 Media has not been changed 

If the driver can return -1 or 1 because it has 
a door-lock or other interlock mechanism, 
MS-DOS performance is enhanced because 
MS-DOS does not need to reread the FAT 
for each directory access. 
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Command code = 2 

BUILD BPB - ES:BX -> 

13-BYTE Request Header 

BYTE media descriptor from DPB 

DWORD transfer address 
(Points to one sector worth of 
scratch space or first sector 
of FAT depending on the value 
of the NON PC-DOS FORMAT bit) 

DWORD pointer to BPB 



If the NON PC-DOS FORMAT bit is 1, then the 
DWORD transfer address points to a sector 
scratch buffer. 

If the NON PC-DOS FORMAT bit is 0, then this 
buffer contains the first sector of the first FAT 
and the driver must not alter this buffer. 

The first sector of the first FAT must be located 
in the same sector for all media. This is because 
the FAT sector is read BEFORE the media is 
actually determined. Use this mode to read the 
FAT ID byte. 

In addition to setting status word, the driver 
must set the pointer to the BPB on return. 

To allow different OEMs to read each other's 
disks, the information relating to the BPB for 
the media is kept in the boot sector of the media. 
The format of the boot sector is: 



Build BPB 
(BIOS 
Parameter 
Block) 
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3 BYTE near JUMP to boot code 




8 BYTES OEM name and version 




WORD bytes per sector 




BYTE sectors per allocation unit 


B 
P 
B 


WORD reserved sectors 


BYTE number of FATs 


WORD number of root dir entries 


WORD number of sectors in logical image 




BYTE media descriptor 




WORD number of FAT sectors 




WORD sectors per track 




WORD number of heads 




WORD number of hidden sectors 



Sectors per track, number of heads, and number 
of hidden sectors are optional. They are intended 
to help the BIOS understand the media. Sectors 
per track may be redundant since it can be cal- 
culated from total size of the disk. Number of 
heads supports different multi-head drives with 
the same storage capacity but a different 
number of surfaces. Number of hidden sectors 
supports drive-partitioning schemes. 
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Media The last two digits of the FAT ID byte are called 

Descriptor the media descriptor byte. Currently, the media 
Byte descriptor byte has been defined for a few media 

types. 



Bit Meaning 

1 = 2 sided; 

1 1 = 8 sector; 

2 1 = removable; 
3-6 must be set to 1 
7 1 = not 80 track; 



5 1/4" disks: 


FEh 


160K 


FCh 


180K 


FFh 


320K 


FDh 


360K 


7Dh 


720K 


HDU: 





F8h 



= not 2 sided 
= not 8 sector 
= not removable 

= 80 track 

formatted single sided 
formatted single sided 



Although these media bytes map directly to FAT 
ID bytes which must be F8-FF, media bytes can, 
in general, be any value in the range 0-FF. 
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Read or Command codes = 3,4,8,9, and 12 

Write 

READ or WRITE - ES:BX (Including lOCTL) -> 



13-BYTE Request Header 

BYTE media descriptor from DPB 

DWORD transfer address 

WORD byte/sector count 

WORD starting sector number 
(Ignored on character devices) 



In addition to setting the status word, the driver 
must set the sector count to the actual number of 
sectors (or bytes) transferred. No error check is 
performed on an lOCTL I/O call. The driver 
must set the return sector (byte) count to the 
actual number of bytes transferred. 

A user program can not request an I/O of more 
than FFFFH bytes and cannot wrap around in 
the transfer segment. 
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Non Command code = 5 
Dcstructiv© 

Read No NON DESTRUCTIVE READ NO WAIT - 

Wait ES:BX -> 



13-BYTE Request Header 
BYTE read from device 



If the character device returns busy bit = 
(characters in buffer), then the next character 
that would be read is returned. This character is 
not removed from the input buffer, hence the 
term Non Destructive Read. Basically, this call 
allows MS-DOS to look ahead one input 
character. 
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Status Command codes = 6 and 10 

STATUS Calls -ES:BX -> 



13-BYTE Request Header 



The driver sets the status word and the busy bit 
as follows: 

• For output on character devices: 

If bit 9 is 1 on return, a write request waits for 
completion of a current request. If it is 0, there is 
no current request and a write request starts 
immediately. 

• For input on character devices with a buffer: 
A return of 1 means a read request goes to the 
physical device. If it is on return, then there 
are characters in the device's buffer and a read 
returns quickly. A return of also indicates that 
the user has typed something. MS-DOS assumes 
that all character devices have an input type- 
ahead buffer. Devices that do not have a type- 
ahead buffer return busy = so that the DOS 
does not wait for something to get into a non- 
existent buffer. 
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Flush Command codes = 7 and 11 

FLUSH Calls - ES:BX -> 



13-BYTE Request Header 



The FLUSH call tells the driver to terminate all 
pending requests. This call is used to flush the 
input queue on character devices. 

Clock Device One of the special enhancements for the Safari-3 
is the battery-backed 581 74 A clock-calender chip 
and related driver. This chip is integrated into 
the system as the CLOCK device and is accessed 
with the TIME and DATE command. 

This CLOCK device defines and performs func- 
tions like any other character device. When a 
read or write to this device occurs, exactly 6 
bytes are transferred. The first two bytes are the 
count of days since 1-1-80. The third byte is min- 
utes, the fourth, hours, the fifth, hundredths of 
seconds, and the sixth, seconds. 

Reading the CLOCK device gets the date and 
time; writing to it sets the date and time. 
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Functional The Asynchronous Communications Element 
Description (ACE) performs serial-to-parallel conversion on 
input data characters received from a modem 
and parallel-to-serial conversion on output data 
characters received from the CPU. You can read 
the status of transfer operations at any time. 
This device gives you modem control capability. 

The baud rate and serial interface characteris- 
tics are programmable. The ACE has a software- 
tailored interrupt system whose interrupt 
request is on INT4. 



Block 
Diagram 



ACE 




MR 




-DOSTR 




" . - 




-CS2 


SIN 


AO 


; ■.■ 


A1 


■■■ 


A2 


-■1 

-DCD 


XTAL1 








-0UT2 





LINE 
DRIVERS 



TxD 
RTS 
DTR 



LINE 

RECEIVERS 



RxD 
GTS 
DSR 
Rl 



INTERFACE 
CONNECTOR 
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Registers 



X Uivi 




RF An/ 




A 




WRITE 

VV Xvl X Hi 




3F8 


2F8 DATA 


R/W 


Receive Buffer, 






W 


Transmitter Holding 








Register 


3F9 


2F9 INTERRUPT ENABLE 


W 


See layout 


3FA 


2FA INTERRUPT IDENTIFICATION 


R 


See layout 


3FB 


2FB LINE CONTROL 


R/W 


See layout 


3FC 


2FC MODEM CONTROL 


R/W 


See layout 


3FD 


2FD LINE STATUS 


R 


See layout 


3FE 


2FE MODEM STATUS 


R/W 


See layout 


3FF 


2FF SCRATCH 


R/W 


Scratch pad register 


3F8 


2F8 DIVISOR LATCH 


W 


Least significant byte 


3F9 


2F9 DIVISOR LATCH 


W 


Most significant byte 



Layout 

INTERRUPT ENABLE REGISTER 

1 
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Functions • IDENTIFY INTERRUPTS 

INPUT: INTERRUPT IDENTIFICATION 
REGISTER 

• READ LINE STATUS 

INPUT: LINE STATUS REGISTER 

• READ MODEM STATUS 

INPUT: MODEM STATUS REGISTER 

• RECEIVE CHARACTER 

INPUT: DATA 

• SEND CHARACTER 

OUTPUT: DATA 
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• SET BAUD RATE 

To set the baud rate, you load the divisor which 
yields the correct rate (16 x divisor = clock fre- 
quency (1.8432 MHz)/baud rate x 16) 

OUTPUT: LINE CONTROL REGISTER 
BIT 7 = 1 

DIVISOR LATCH - Least significant byte 
DIVISOR LATCH - Most significant byte 

• SET INTERRUPTS 

OUTPUT: INTERRUPT ENABLE 
REGISTER 

• WRITE LINE CONTROL 
CHARACTERISTICS 

OUTPUT: LINE CONTROL REGISTER 

• WRITE MODEM CONTROL 
CHARACTERISTICS 

OUTPUT: MODEM CONTROL REGISTER 



Sequencing To transmit a character, first issue a Request to 
and Timing Send and Data Terminal Ready to the Modem 
Control Register. Then wait for the Modem Stat- 
us to have Data Set Ready and Clear to Send 
set. When the Transmitter Holding Register is 
empty as indicated in the Line Status Register, 
write the character to the data register. 

To receive a character, set Data Terminal Ready 
in the Modem Control Register. Then wait for 
Data Set Ready in the Modem Status Register. 
When Data Ready in the Line Status Register is 
set, input the character from the data register. 
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The following table states the divisors to use to 
obtain a given baud rate. 



BAUD RATES USING 1.8432 MHz CLOCK 



If you wish to use the break control feature to 
alert a terminal in a communication system, the 
following sequence assures that no erroneous or 
extraneous characters are transmitted. 

• Load an all O's pad character into the transmit- 
ter holding register. 

• Set break when the transmitter holding register 
is empty. 

• Wait for transmitter empty (Bit 6 = 1 in Line 
Status Register) and clear break. 

Note that the transmitter operates normally dur- 
ing a break sequence and can be used as a char- 
acter timer to establish an accurate break 
length. 



BAUD RATE 



DIVISOR 



110 
150 
300 
600 
1200 
1800 
2000 
2400 
3600 
4800 
7200 
9600 



1047 
768 
384 
192 
96 
64 
58 
48 
32 
24 
16 
12 
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If the ACE is programmmed to interrupt, the 
interrupt is on INT4. The ACE acknowledges 
the highest priority interrupt as indicated in this 
chart. The Interrupt Identification Register 
states which interrupt is pending. 



TYPE 



SOURCE 



- RESET 



Receiver Line Status Overrun Error — Read Line Status 

Register 

Parity Error 
Framing Error 
Break Interrupt 

Receive Data Ready — Read data 
Transmitter Holding — Write data 
Register Empty 

Clear To Send — Read Modem Status 
Register 

Data Set Ready 
Ring Indicator 
Data Carrier Detect 



Received Data Ready 
Transmitter Holding 
Register Empty 
Modem Status 
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Sample ;This program sets the baud rate to 1200 baud 

Program LINE_CTL EQU 3FB 

DVSR_L EQU3F8 

DVSR_M EQU3F9 



SET_BAUD: 
MOV AL,080H 
MOV DX,LINE_CTL 
OUT DX,AL 

MOV AX,096 
MOV DX,DVSR_L 
OUT DX,AL 

MOV DX,DVSR_M 
MOV AL,AH 
OUT DX,AL 

XORAL,AL 

MOV DX,LINE_GTL 

OUTDX,AL 

RET 



;access divisor 
;latch 

;di visor for 1200 baud 
;least significant byte 

;most significant byte 
;tum off access to latch 
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Functional The DMA controller allows devices to transfer 
Description data directly to and from memory without CPU 
involvement. It has four channels. 

Channel has the highest priority and is used to 
refresh memory. The Interval Timer is pro- 
grammed to periodically request a dummy DMA 
transfer. This creates a memory read cycle 
which refreshes memory. 

Channel 1 is available on the I/O expansion bus 
to support high speed transfer between I/O 
devices and memory. Channel 3 has the lowest 
priority. 

Channel 3 is dedicated to the hard disk con- 
troller. Channel 2 is dedicated to the floppy disk 
controller. 

The DMA controller has four transfer modes. 
Single transfer mode makes only one transfer. 
Block transfer mode continues transferring until 
the count goes from to FFFFH. Demand 
transfer allows transfers to continue until the 
I/O device has exhausted its capacity. The cas- 
cade mode allows more than one DMA controller 
to be used and is not applicable in the AT&T 
Personal Computer 6300. 

When autoinitialize is requested, the original 
values of the Current Address and Current 
Count registers are restored at the end of the 
operation. 
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The DMA controller has two types of priority 
schemes. The fixed scheme bases the priority on 
the descending value of their numbers. In this 
scheme, Channel 3 has the lowest priority. The 
second scheme is rotating priority. The last 
channel to get service becomes the lowest prior- 
ity channel. 

Compressed Timing allows greater throughput 
by compressing the transfer time into two clock 
cycles. 



Block 
Diagram 
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Registers 



PORT NAME READ/ DESCRIPTION 

WRITE 






CHANNEL 


ADDRESS 


W 


16 bit address 


1 


CHANNEL 


COUNT 


W 


I's complement of # of bytes 










to transfer 





CHANNEL 


CURRENT ADDRESS 


R 


16 bit address 


1 


CHANNEL 


CURRENT COUNT 


R 


I's complement of # of bjdies 










to transfer 


2 


CHANNEL 1 


ADDRESS 


W 


16 bit address 


3 


CHANNEL 1 


COUNT 


w 


I's complement of # of bytes 










to transfer 


2 


CHANNEL 1 


CURRENT ADDRESS 


R 


16 bit address 


3 


CHANNEL 1 


CURRENT COUNT 


R 


I's complement of # of bytes 










to transfer 


4 


CHANNEL 2 


ADDRESS 


W 


16 bit address 


5 


CHANNEL 2 


COUNT 


W 


I's complement of # of bytes 










to transfer 


4 


CHANNEL 2 


CURRENT ADDRESS 


R 


16 bit address 


5 


CHANNEL 2 


CURRENT COUNT 


R 


I's complement of # of bytes 










to transfer 


6 


CHANNEL 3 


ADDRESS 


W 


16 bit address 


7 


CHANNEL 3 


COUNT 


W 


I's complement of # of bjd;es 










to transfer 


6 


CHANNEL 3 


CURRENT ADDRESS 


R 


16 bit address 


7 


CHANNEL 3 


CURRENT COUNT 


R 


I's complement of # of bytes 










to transfer 


8 


STATUS 




R 


See layout 


8 


COMMAND 




W 


See layout 


9 


REQUEST 




w 


See layout 


A 


SINGLE MASK 


w 


See layout 


B 


MODE 




w 


See layout 


C 


CLEAR FLIP/FLOP 


w 


Execute prior to read or 










write of address or count 


D 


TEMPORARY 


R 


Contains last byte of 










memory-to-memory transfer 
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D MASTER CLEAR 

E CLEAR MASK 

F WRITE ALL MASK 

80 CHANNEL SEGMENT 

82 CHANNEL 1 SEGMENT 

81 CHANNEL 2 SEGMENT 

83 CHANNEL 3 SEGMENT 

Layout 



W Any write clears controller 

W Clear mask, all channels 
accept DMA commands 

W See layout 

W Address segment nybble 

W Address segment nybble 

W Address segment nybble 

W Address segment nybble 



COMMAND 
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REQUEST REGISTER 
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Functions • DISABLE CONTROLLER 

This function disables the controller. 
OUTPUT: COMMAND REGISTER 
BIT 2 = 1 

• MASTER CLEAR CONTROLLER 
This function clears the controller. The 
Command, Status, Request, Temporary and 
Flip/Flop Registers are cleared. 
OUTPUT: MASTER CLEAR 

• DMA READ, WRITE OR VERIFY 

This function sets up the controller to do the 

desired operation. 

OUTPUT: CLEAR FLIP/FLOP 

MODE REGISTER 
BITS 0-1 channel 
BITS 2-3 function 
BIT 4 autoinitialize 
BIT 5 address increment or 

decrement 
BITS 6-7 mode 

ADDRESS REGISTER 

16 BIT address, first output the 
LSB and then the MSB 

SEGMENT NYBBLE 

One nybble. The significant nybble 
of the segment register is in bits 
12-15. Rotate to Bits 0-3 before 
output. 

COUNT REGISTER 

16 bit I's complement of the # of 
bytes. First output the LSB and 
then the MSB. 
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• REQUEST DMA SERVICE 

This is a software request for DMA services. 
OUTPUT: REQUEST REGISTER 

• READ STATUS 

This function reads the channel status. 
INPUT: STATUS REGISTER 

• WRITE COMMAND REGISTER 

This function controls the operation of the DMA 
controller. 

OUTPUT: COMMAND REGISTER 

• WRITE ALL MASK REGISTER 

This function enables and disables automatic 

DMA transfer for all channels. 

OUTPUT: WRITE ALL MASKS REGISTER 

• WRITE MASK REGISTER 

This function enables and disables automatic 
DMA transfers for a channel. 
OUTPUT: MASK REGISTER 

• WRITE MODE REGISTER 

This function specifies the mode for the specified 
channel. 

OUTPUT: MODE REGISTER 

• CLEAR MASKS 

This function clears all the masks so that all 
channels accept DMA commands. 
OUTPUT: CLEAR MASK REGISTER 
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Sequencing 
and Timing 



Sample 
Program 



When the system is powered-up, it is recom- 
mended that all mode registers be set with valid 
data even if the channel is not used. 

Before loading the address and count registers, 
disable the controller (BIT 2 of COMMAND 
REGISTER) or mask the channel. This prevents 
erroneous transfers before a complete address is 
loaded. 

A write to the Clear Flip/Flop sets the controller 
so that an access to an address or count is to the 
upper and lower byte in the correct sequence. 

;This program initializes an unused channel 
;at start-up 

COMMAND EQU 8 
MODE EQU B 



INIT_CHAN: 
MOV AL,04H 
OUT COMMAND,AL 
MOV AL,041H 



;disable controller 



;channel 1, verify, inc. 
;addr 

; single mode 
;now setup other 
;channels 



OUT MODE,AL 
RET 
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Functional The diskette interface and NEC uPD765 con- 
Description troUer read and write 51/4 inch diskettes on as 
many as two drives. Single density (FM) or dou- 
ble density (MFM) formats are supported. Single 
density diskettes contain 163,840 bytes and dou- 
ble density diskettes contain 327,680 bytes. 

Each sector on the diskette contains an ID field 
and the Data field. The ID field contains the 
cylinder number, the head number, the sector 
number and the number of bytes per sector. 

The diskette controller performs 15 separate 
functions. It operates in either DMA or non- 
DMA mode. Interrupts can be enabled on INT6. 



Block 
Diagrams 




COMPENSATION 
CIRCUIT 



■0- 





1 






- |cDCR?T 1 


PECODEB 
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TERMINAL 
COUNT 



DRQ- 
-DACK- 
INT- 

lORD 
-RD- 
-WR- 

lOWR 

AO- 



DATA 
'BUS 
BUFFER 



:REA6/ 

'WRITE/: 
DMA" 
■OICONTROL 
LOGIC 



SERIAL 
INTERFACE 
CONTROLLER 



DRIVE 
INTERFACE 
CONTROLLER 



■WR CLOCK 
-WR DATA 
-WR ENABLE 

- PRE-SHIFTO 
■ PRE-SHIFT1 

- RO DATA 

- READ DATA WINDOW 
-VCD SYNC 



INPUT 
PORT 













READY 

WRITE PROTECT/TWO 
" SIDE 
• INDEX 

■ FAULT/TRACK 



OUTPUT 
PORT 





















UNIT SELECT 
UNIT SELECT 1 
MFM MODE 

-RW/SEEK 
HEAD LOAD 
HEAD SELECT 
LOW CURRENT/ 
DIRECTION 
FAULT RESET/STEP 



Registers 

PORT NAME READ/ DESCRIPTION 

WRITE 

3F2 INTERFACE OUTPUT CONTROL W See layout 
3F4 FDC MAIN STATUS REGISTER R See layout 
3F5 FDC DATA R/W Transfers data, commands, 

parameters, and status 
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Layout 

INTERFACE OUTPUT CONTROL 



1 
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STATUS REGISTER 2 

1 




STATUS REGISTER 3 

1 
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Parameters 

SYMBOL NAME 
DTL Data Length 



EOT 

GPL 

HD 
HLT 

HUT 



MF 
MT 



N 

ND 
SRT 



End of Track 
Gap Length 
Head 

Head Load Time 
Head Unload Time 



MF or MFM Mode 
Multi-track 



Number of bytes/ 
sector 
Non-DMA 
Step Rate Time 



ST0-ST3 Status Registers 
STP Scan Test Flag 

USO.USl Unit Select 



DESCRIPTION 

Only applies when there are 128 bytes per 

sector. If so, number of bytes to read or 

write. Otherwise, DTL = FF. 

Last sector number on cylinder. If there are 

8 sectors per cylinder, then EOT = 8. 

Gap 3 length between sectors. Different for 

format and read/write commands. 

Selected Head number. 

4ms to 508ms in 4ms increments for 8Mhz 

clock. In this case, 4ms. 

0ms to 480ms in 32ms increments for 8Mhz 

clock. This is the amount of time to wait 

after a read or write before the heads are 

unloaded. If a new command is issued 

quickly, this saves head load time. 

= MF, 1 = MFM 

MT = 1, multi-track operation. After com- 
pleting an operation on side 0, the FDC con- 
tinues on side 1. 

= 128 bytes, 1 = 256 bytes, 2 = 512 bytes 
3 = 1024 bytes 

= DMA mode, 1 = non-DMA mode 
32ms to 2ms in 2 ms increments for 8Mhz 
clock. This is the amount of time to move 
the head from track to track. At 48 TPI, 
SRT = 6 ms. At 96 TPI, SRT = 4ms. 
See layout 

STP = 1, sector by sector compare 
STP = 2, alternate sectors 
USx = 0, drive not selected 
USx = 1, drive selected 
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Functions • FORMAT A TRACK 

This function formats an entire track. The ID 
Field for each sector is supphed by the pro- 
grammer during the execution phase. 



OUTPUT: 



EXECUTION: 
INPUT: 






MF 








1 


1 





1 



















HD 


USl 


uso 



Number of bytes/sector 

Sector/track 

Gap Length 

Filler Byte 

Sector ID Field transfer 
Status Register 
Status Register 1 
Status Register 2 
Cylinder 
Head 
Sector 

Number of bytes/sector 



POSSIBLE 
ERRORS: 



Equipment check, and not ready 
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• READ DATA 

This function reads data from the diskette. 



OUTPUT: 



EXECUTION: 
INPUT: 



POSSIBLE 
ERRORS: 



MT 


MF 


SK 








1 


1 




















HD 


USl 


USO 



Cylinder 

Head 

Sector 

Number of bytes/sector 

End of Track 

Gap Length 

Data Length 

Data Transfer 

Status Register 

Status Register 1 

Status Register 2 

Cylinder 

Head 

Sector 

Number of bytes/sector 

No data, data error, data error 
in data field, and control mark 
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• READ DELETED DATA 

This function reads deleted data. 



MT 


MF 


SK 





1 


1 























HD 


USl 


uso 



Cylinder 

Head 

Sector 

Number of bytes/sector 

End of Track 

Gap Length 

Data Length 
EXECUTION: Data Transfer 
INPUT: Status Register 

Status Register 1 

Status Register 2 

Cylinder 

Head 

Sector 

Number of bytes/sector 

• READ ID 

This function reads the first correct sector ID 
field. 



OUTPUT: 



EXECUTION: 
INPUT: 






MF 








1 





1 




















HD 


USl 


uso 



Status Register 
Status Register 1 
Status Register 2 
Cylinder 
Head 
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Sector 

Number of bytes/sector 

POSSIBLE 

ERRORS: Missing address mark and 
no data 



• READ TRACK 

This function reads all data fields from the 
index hole to EOT. The FDC continues reading 
even if it finds a CRC error in the ID or data 
fields. 



OUTPUT: 



EXECUTION: 
INPUT: 



POSSIBLE 
ERRORS: 






MF 


SK 











1 




















HD 


USl 


USO 



Cylinder 

Head 

Sector 

Number of bytes/sector 

End of Track 

Gap Length 

Data Length 

Data transfer 

Status Register 

Status Register 1 

Status Register 2 

Cylinder 

Head 

Sector 

Number of bytes/sector 

No data, data error and missing 
address mark 
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• RECALIBRATE 

This function positions the head to head 0, 
cy Under or track 0. 



OUTPUT: 


















1 


1 


1 




1 














USl 


uso 



EXECUTION: 

POSSIBLE 
ERRORS: 



Head repositioned 
Equipment check 



• SCAN EQUAL 

This function scans for an equal data compare. 



OUTPUT: 



MT 


MF 


SK 


1 











1 

















HD 


USl 


uso 



CyHnder 

Head 

Sector 

Number of bytes/sector 
End of track 
Gap Length 

Contiguous or alternate sectors 
EXECUTION: Data transfer 
INPUT: Status Register 

Status Register 1 

Status Register 2 

Cylinder 

Head 

Sector 

Number of bytes/sector 
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• SCAN LOW OR EQUAL 

This function scans for a low or equal data 
compare. 



OUTPUT: 



EXECUTION: 
INPUT: 



MT 


MF 


SK 


1 


1 








1 

















HD 


USl 


uso 



Cylinder 

Head 

Sector 

Number of bytes/ sector 
End of track 
Gap Length 

Contiguous or alternate sectors 

Data transfer 

Status Register 

Status Register 1 

Status Register 2 

Cylinder 

Head 

Sector 

Number of bytes/sector 
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• SCAN HIGH OR EQUAL 

This function scans for a high or equal data 
compare. 



OUTPUT: 



MT 


MF 


SK 


1 


1 


1 





1 

















HD 


USl 


uso 



Cylinder 

Head 

Sector 

Number of bytes/sector 
End of track 
Gap Length 

Contiguous or alternate sectors 
EXECUTION: Data transfer 
INPUT: Status Register 

Status Register 1 

Status Register 2 

Cylinder 

Head 

Sector 

Number of bytes/sector 

• SEEK 

This function positions the head at the requested 
cylinder. 

OUTPUT: 















1 


1 


1 


1 

















HD 


USl 


uso 



New cylinder number 
EXECUTION: Heads repositioned 
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• SENSE DRIVE STATUS 

This function obtains the current drive status. 



OUTPUT: 



INPUT: 


















1 























HD 


USl 


uso 



status Register 



SPECIFY 

This function defines the drive parameters. 



OUTPUT: 





















1 


1 


SRT 


HUT 


HLT 


ND 



WRITE DATA 

This function writes data. 



OUTPUT: 



MT 


MF 











1 





1 

















HD 


USl 


uso 



CyHnder 

Head 

Sector 

Number of bytes/ sector 

End of Track 

Gap Length 

Data Length 
EXECUTION: Data Transfer 
INPUT: Status Register 

Status Register 1 

Status Register 2 

Cylinder 

Head 

Sector 

Number of bytes/ sector 
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• WRITE DELETE DATA 

This function writes deleted data. 



MT 


MF 








1 








1 

















HD 


USl 


uso 



Cylinder 

Head 

Sector 

Number of bytes/sector 

End of Track 

Gap Length 

Data Length 
EXECUTION: Data Transfer 
INPUT: Status Register 

Status Register 1 

Status Register 2 

Cylinder 

Head 

Sector 

Number of bytes/sector 



Sequencing There are three phases to each function: 
and Timing 

• command - The programmer writes the required 

information to the FDC. 

• execution - The FDC performs the operation. 

• result - The programmer reads the FDC's status. 
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Before any data can be read or written to the 
FDC the Main Status Register (MSR) must be 
read to determine the status of Bit 6 and Bit 7. 
In the command phase, Bit 6 must be and Bit 7 
must be 1. In the result phase both bits must be 
1. You must wait 12 usee after a data read or 
write before reading the MSR. 

In the command phases, all output must be writ- 
ten. The same is true in the result stage. All sta- 
tus information must be read. 

During the execution phase, the FDC operates in 
DMA mode or non-DMA mode. In DMA mode, 
there is one interrupt at the end of the phase. In 
non-DMA mode, there is an interrupt after the 
transfer of each byte. In the format command, 
the ID field information for all the sectors in a 
track is sent to the FDC (cylinder, head, sector 
and bytes/sector). In DMA mode, 4 DMA 
requests per sector are issued. In non-DMA 
mode, there are 4 interrupts per sector. If inter- 
rupts cannot be handled every 13 ms in MFM 
mode or every 27 ms in FM then the FDC is 
polled. When polling, Bit 7 in the MSR functions 
just like the interrupt. 

When it is not executing a command, the FDC 
polls the drives looking for a change in drive 
ready. If there is a change, the FDC interrupts. 
You can determine the cause of the unexpected 
interrupt with the Sense Drive Status function. 

The drive motors should be off when the drives 
are not in use. However, they must be on prior to 
a drive select. 

During the execution phase of read and write 
commands, the following occurs: 
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• The heads are loaded if unloaded. 

• The FDC waits for the head settle time to elapse. 

• The FDC begins reading the ID address marks 
and ID field. 

• When the requested sector number compares 
with the one on the diskette, the transfer begins. 

• After completion of the transfer, the FDC waits 
the head unload time before unloading the 
heads. 



The amount of data that can be transferred in 
one instruction depends on MT, MF, and N. 



Multi-Track 


MFM/FM 


Bytes/Sector 


Maximum Transfer 


MT 


MF 


N 


(Bytes/Sector)(Number of Sectors) 








00 


128*26= 3,328 





1 


01 


256*26= 6,656 


1 





00 


128*52= 6,656 


1 


1 


01 


256*52 = 13,312 








01 


256*15= 3,840 





1 


02 


512*15= 7,680 


1 





01 


256*30= 7,680 


1 


1 


02 


512*30 = 15,360 








02 


512*8 = 4,096 





1 


03 


1024*8 = 8,192 


1 





02 


512*16= 8,192 


1 


1 


03 


1024*16 = 16,384 



If a read or write terminates on error, then the 
values for cylinder, head, sector, and number of 
bytes per cylinder depends on the state of MT 
and EOT. 
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LAST SECTOR 

MT HD TRANSFERRED ID INFORMATION IN RESULTS 







EOT 


C 


H 


S 


N 








Less than EOT 


NC 


NC 


S+1 


NC 








Equal to EOT 


C+1 


NC 


S=l 


NC 





1 


Less than EOT 


NC 


NC 


s+1 


NC 





1 


Equal to EOT 


C+1 


NC 


S=l 


NC 


1 





Less than EOT 


NC 


NC 


s+1 


NC 


1 





Equal to EOT 


NC 


LSB 


S=l 


NC 


1 


1 


Less than EOT 


NC 


NC 


s+1 


NC 


1 


1 


Equal to EOT 


C+1 


LSB 


S=l 


NC 



NC = No Change 

LSB = Least Significant Bit 



The Write Deleted Data is the same as Write 
Data except that the FDC writes a Deleted Data 
Address mark at the beginning of the Data Field 
instead of the normal Data Address Mark. When 
reading deleted data, the FDC sets the CM error 
in Status Register 2 and reads the data. A Read 
Data would not read the data. If SK = 1, then 
the FDC skips the sector with the Deleted Data 
Address mark and reads the next one. 

The Gap Length is different for read, write, and 
format commands. This table suggests approp- 
riate values. 
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FORMAT 


SECTOR SIZE 


N 




OPT /I ^ 




FM 


128 


00 


12 


07 


09 


FM 


128 


00 


10 


10 


19 


FM 


256 


01 


08 


18 


30 


FM 


512 


02 


04 


46 


87 


FM 


1024 


03 


02 


C8 


FF 


FM 


2048 


04 


01 


C8 


FF 


MFM 


256 


01 


12 


OA 


OC 


MFM 


256 


01 


10 


20 


32 


MFM 


512 


02 


08 


2A 


50 


MFM 


1024 


03 


04 


80 


FO 


MFM 


2048 


04 


02 


C8 


FF 


MFM 


4096 


05 


01 


C8 


FF 



GPL(l) - Suggested GPL in read and write commands 
GPL(2) - Suggested GPL in format commands 



The scan commands terminate when a scan 
condition is met, last sector on the track is 
reached, or a terminal count is received. The 
DMA issues the terminal count when it has no 
more data to send. This chart determines the 
result of the scan. 



COMMAND STATUS REGISTER 2 

BIT 2 BIT 3 

SCAN EQUAL 1 DISKETTE 

SCAN EQUAL 1 DISKETTE 

SCAN LOW OR EQUAL 1 DISKETTE 
SCAN LOW OR EQUAL DISKETTE 
SCAN LOW OR EQUAL 1 DISKETTE 
SCAN HIGH OR EQUAL 1 DISKETTE 
SCAN HIGH OR EQUAL DISKETTE 
SCAN HIGH OR EQUAL 1 DISKETTE 



COMMENT 

DATA = PROCESSOR DATA 
DATA > < PROCESSOR DATA 
DATA = PROCESSOR DATA 
DATA < PROCESSOR DATA 
DATA > PROCESSOR DATA 
DATA = PROCESSOR DATA 
DATA > PROCESSOR DATA 
DATA < PROCESSOR DATA 



Scans allow the compare to be on contiguous 
sectors (STP = 1) or alternate sectors (STP = 2). 
However, for normal termination of the com- 
mand the last sector on the track must be 
compared. 
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When a seek is requested, the FDC checks its 
current position and decides in which direction 
to move. Then step pulses are issued to move the 
heads. The speed of the pulse is controlled by the 
Step Rate Time in the Specify function. While 
the drive is seeking, the seek bit in the MSR is 
set. It must be cleared by Sense Interrupt Status 
at the completion interrupt. While a drive is 
seeking, the FDC is not busy. Another seek 
command to the other drive can be requested. 

Interrupts occur as the result of: 

1) Entering Result Phase of: 

Read Data 
Read Track 
Read Deleted Data 
Write Data 
Write Deleted Data 
Format Track 
Scans 

2) The execution phase in non-DMA mode 

3) The Drive Ready line changing state 

4) The end of Seek or Recalibrate 

When the latter two occur, a Sense Drive Status 
determines the cause of the interrupt. It is man- 
datory to follow Seek and Recalibrate functions 
with a Sense Drive Status. This chart shows 
how to interpret the results of a Sense Drive 
Status. 



STATUS REGISTER 
BIT 5 BIT 6 E 



CAUSE 



BIT 7 




1 



1 



1 




1 



1 








Ready line changed state 
Normal termination of Seek or 
Recalibrate 

Abnormal termination of Seek or 
Recalibrate 
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Sample 
Program 



The Specify command defines internal timers. 
Head Unload Time (HUT) is programmable 
from 32ms to 480ms in increments of 32ms. 
Therefore 1 = 32ms, 2 = 64ms, and F = 480ms. 
The Step Rate Time is programmable from 2ms 
to 32ms in increments of 2ms. In this case, F = 
2ms, E = 4ms, and 1 = 32ms. The Head Load 
Time is programmable from 4ms to 508ms in 
increments of 4ms. In this case, 1 = 4ms, 2 = 
8ms, 7F = 508ms. 

GET_RESULTS 

This subroutine obtains a variable amount 
of status information in the result phase. 

INPUT: ES:DI points to the area that receives 
the status bytes 



GETl: 

MOV DX, NEC_STATUS ;port address of MSR 



NEC_STATUS 



EQU 3F4 



GET_RESULTS: 
MOV CX,7 



;max. bytes in status 



IN AL,DX 
TEST AL,080H 



;get MSR 

;Data register ready to 
;send or receive 
;jump if not ready yet 
;direction bit 
;jump if wrong 
;direction 
;port addr of data 
;register 

;get one byte of status 
;move it to status area 
;maximum number 
Jump if not max yet 



JZ GETl 
TEST AL,40H 
JZ GET2 



INC DX 



IN AL,DX 
STOSB 
DEC CX 
JNZ GETl 



GET2:RET 
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Functional The DTC-5150BX hard disk controller reads and 
Description writes to a maximum of two standard 5 1/ 4" 

Winchester disk drives. A sector size of 256, 512, 
or 1024 bytes is selectable. The sectors can be 
interleaved in 16 different ways. 

The hard disk controller operates in DMA or 
non-DMA mode. Interrupts can be enabled on 
INT5. 

Extensive diagnostics are implemented. If a cor- 
rectable data error is discovered, the error is 
automatically corrected using ECC. 



Registers 



3RT# 


NAME 


READ/ 


DESCRIPTION 






WRITE 




320 


COMPLETION STATUS 


R 


See layout 




REGISTER 






320 


DATA 


R/W 


Transfers data, function bytes, and 








controller sense bytes. See layout. 


321 


RESET CONTROLLER 


W 


Initialize Controller 


321 


STATUS 


R 


See layout 


322 


SELECT CONTROLLER 


W 


Select Controller 


322 


DRWE TYPE 


R 


See layout 


323 


CONTROL REGISTER 


W 


See layout 
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CONTROL COMMAND 

1 
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Error Codes 



TYPE 


CODE 


DESCRIPTION 








No error status 





1 


No index signal 





2 


No seek complete within 1.0 seconds 





3 


Write fault 





4 


Drive not ready 





6 


No track 





8 


Seek in progress 


1 





ID read error. ECC error in the ID field. 


1 


1 


Uncorrectable data error during a read 


1 


2 


All HiTI if* 1 

Address Mark not found 


1 


4 


Record not found. Found correct cylinder and 






head. 


1 


5 


Seek error. Read/ Write head positioned on 






wrong cylinder and/or wrong head selected. 


1 


8 


Correctable data field error 


1 


9 


Bad sector found 


1 


A 


Format error. An unexpected format 






discovered during the Check Track function. 


1 


C 


Unable to read the alternate track address 


1 


E 


Attempted to directly access and alternate 






track 


2 





Invalid function 


2 


1 


Illegal disk address. Address is beyond 






maximum. 


3 





RAM error. Data error detected during RAM 






diagnostic 


3 


1 


Program Memory Checksum error 


3 


2 


ECC Polynominal error 
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Function 
Parameters 



NAME 



DESCRIPTION 



CONTROL COMMAND Tells controller how to react to an error 

condition and defines step mode. See 
layout. 

Eight least significant bits of the 
cylinder number 
Two most significant bits of the 
cylinder number 

ECC bytes of sector. ECCO is least sig- 
nificant byte. 
Head number 

Logical Unit Number. Winchester Drive 

1 = Lun 0, Winchester Drive 2 = Lun 1. 
Sector number 

Gives detailed error information. See 
layout. 

= good track, 1 = alternate track, 

2 = bad track, 3 = alternate bad track 



CYLINDER LOW 

CYLINDER HIGH 

ECC0,ECC1,ECC2 

HEAD# 
LUN# 

SECTOR # 
SENSE BYTE 

TYPE 



Functions • ASSIGN ALTERNATE TRACK 

This function formats the primary track speci- 
fied in the function block with the alternated 
and bad track flags set in the ID fields and with 
the track address of the alternate track written 
in the data fields. The data field is written with 
the data in the sector buffer. 

Future read/write accesses to the primary track 
cause the drive to seek to the alternate track and 
to perform the operation there. This is transpar- 
ent to the software. Alternate tracks can be 
assigned once. An alternate track cannot point 
to another alternate track. 
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OUTPUT: 



11 



LUN 



PRIMARY 
HEAD# 



CYL 
HI 

PRIMARY CYLINDER 
LOW 



INTERLEAVE 



CONTROL 



DATA 
OUTPUT: 



7 


6 


5 


4 


3 


2 


1 














SECONDARY 
HEAD# 


CYL HI 





SECONDARY CYLINDER 
LOW 






CHECK TRACK 

This function checks the track format on the 
specified track for the correctness of the ID fields 
and the interleave of the sectors. It does not read 
the data. 
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OUTPUT: 



10 



LUN 



CYL HI 



HEAD# 



CYLINDER LOW 



INTERLEAVE 



CONTROL 



CONTROLLER INTERNAL DIAGNOSTICS 
This function performs the controller internal 
diagnostics. The controller checks the internal 
processor, data buffer, ECC circuit and the 
checksum. 



OUTPUT: 



765432 1 







E4 



• COPY 

This function transfers the data blocks from the 
source unit to the destination unit. The number 
of sectors to copy is specified in the number of 
blocks field. If the field is zero, 15,777,216 sectors 
are copied. 
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7 6 5 


4 3 2 1 


AO 


LUN/S 


HEAD #/S 


CYL HI/S 


SECTOR #/S 


CYLINDER LOW/S 


LUN/D 


HEAD #/D 


CYL HI/D 


SECTOR #/D 



CYLINDER LOW/D 



# OF BLOCKS 2 



# OF BLOCKS 1 



# OF BLOCKS 







CONTROL 



S = Source D = Destination 
DRIVE DIAGNOSTIC 

This function performs a diagnostic on the spec- 
ified unit. It reads sector on sequential tracks 
and then reads sector on 256 random tracks. 
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OUTPUT: 



E3 



LUN 











CONTROL 



• FORMAT BAD TRACK 

This function formats the track with the bad 
block flag set in all ID fields. It fills the data 
field with the data pattern in the sector buffer. 
The interleave must be the same for the entire 
drive. 



OUTPUT: 



LUN 



HEAD# 



CYL HI 



CYLINDER LOW 



INTERLEAVE 



CONTROL 
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FORMAT TRACK 

This function formats the specified track with 
no flags set in the ID fields. It fills the data field 
with the data pattern in the sector buffer. The 
interleave must be the same for the entire drive. 



OUTPUT: 



6 







LUN 



CYL HI 



HEAD# 



CYLINDER LOW 



INTERLEAVE 



CONTROL 



FORMAT DRIVE 

This function formats all of the tracks starting 
with the one specified in the function block to 
the end of the drive. The selected track format is 
used. The sectors are placed on the tracks 
according to the interleave code. The data fields 
are filled with the data pattern from the sector 
buffer. 



OUTPUT: 



6 







LUN 



CYL HI 



HEAD# 







CYLINDER LOW 



INTERLEAVE 



CONTROL 
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INITIALIZE DRIVE CHARACTERISTICS 
This function sets up the drive with different 
capacities and characteristics. 



OUTPUT: 



6 



LUN 



DATA 
OUTPUT: 



MAX # OF CYLINDERS HIGH 



MAX # OF CYLINDERS LOW 



MAX # OF HEADS 



REDUCED WR. CUR. 
CYLINDER HIGH 



REDUCED WR. CUR. 
CYLINDER LOW 



WRITE PRECOMP. 
CYLINDER 
HIGH 



WRITE PRECOMP. 
CYLINDER 
LOW 



MAX ECC DATA BURST 
LENGTH 
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RAM DIAGNOSTIC 

This function performs a data pattern test on 
the controller RAM. 

OUTPUT: 







EO 



READ 

This function reads the specified number of 
blocks. The function specifies the initial sector 
address. The data is transferred to the CPU. 



OUTPUT: 



LUN 



CYL HI 



HEAD# 



SECTOR # 



CYLINDER LOW 



# OF BLOCKS 



CONTROL 
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• READ ECC BURST ERROR LENGTH 

This function transfers one byte of data to the 
CPU. This byte contains the ECC burst length 
that the controller detected for the correctable 
ECC data error during the last read function. 



OUTPUT: 



D 























DATA 
INPUT: 



ECC BURST LENGTH 
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READ ID 

This function reads three bytes and three ECC 
bytes from the specified sector address given in 
the function block and transfers them to the 
CPU. 



E2 



LUN 



HEAD# 



CYL HI 



SECTOR # 



CYLINDER LOW 



INTERLEAVE 



CONTROL 



CYLINDER LOW 



TYPE 



CYL HI 



HEAD# 



SECTOR # 



ECC 2 



ECC 1 



ECCO 
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• READ LONG 

This function reads sectors of data and ECC 
bytes from the disk and transfers them to the 
CPU. If an ECC error occurs during the read, 
the controller does not attempt to correct the 
data. 



OUTPUT: 



E5 



LUN 


HEAD# 


CYL HI 


SECTOR # 



CYLINDER LOW 



# OF BLOCKS 



CONTROL 



DATA 
INPUT: 



256/512/1024 


E 


E 


E 





BYTES OF DATA 


C 


C 


C 







2 


1 








• READ SECTOR BUFFER 

This function reads one sector from the con- 
troller sector buffer. No data transfer occurs 
between the controller and the drives. 
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OUTPUT: 



E 







READ VERIFY 

This function reads the specified number of 
blocks but does not transfer the data to the CPU. 
The function specifies the sector number where 
verification begins. 



OUTPUT: 



LUN 



CYL HI 



HEAD# 



SECTOR # 



CYLINDER LOW 



# OF BLOCKS 



CONTROL 



RECALIBRATE 

This function positions the read/ write arm at 
track and clears errors in the drive. 
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LUN 



OUTPUT: 











CONTROL 



• REQUEST LOGOUT 

This function retrieves the four bytes of error log 
for the specified unit. Each device has its own 
error log which is incremented every time cer- 
tain errors occur and is cleared after this func- 
tion is executed. 



OUTPUT: 



E7 



LUN 
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DATA 
INPUT: 



RETRY COUNT HIGH 



RETRY COUNT LOW 



PERMANENT ERROR HIGH 



PERMANENT ERROR LOW 



REQUEST SENSE 

This function sends the four Sense Bytes to the 
CPU as data. 



LUN 



SENSE BYTE 



LUN 



HEAD# 



CYL HI 



SECTOR # 



CYLINDER LOW 
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• REQUEST SYNDROME 

This function returns the four bytes of the ECC 
syndrome to the CPU as data. 



OUTPUT: 



DATA 
INPUT: 



LUN 



MSB bit offset 



LSB bit offset 



MASK 
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• SEEK 

This function seeks to the cyhnder of the speci- 
fied block. For Winchester drives capable of 
overlap seeks, this function returns completion 
status before the seek is complete. 

OUTPUT: 



7 6 5 


4 3 2 1 


B 


LUN 


HEAD# 


CYL HI 






CYLINDER LOW 







CONTROL 



• TEST DRIVE READY 

This function selects the specified drive and 
verifies the drive is ready, the seek is complete, 
and there are no drive faults. 



OUTPUT: 



6 







LUN 
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• WRITE 

This function writes the data starting at the 
initial block address given in the function. 



OUTPUT: 



7 



6 



1 



LUN 



CYL HI 



CYL 



HEAD# 



SECTOR # 



NDER LOW 



# OF BLOCKS 



CONTROL 



A 



WRITE LONG 

This function writes blocks of data and ECC 
bytes from the CPU to the disk without generat- 
ing ECC for the data. 



DATA 
OUTPUT: 



OUTPUT: 


7 


6 


5 


4 


3 


2 


1 







E6 




LUN 


HEAD# 




CYL HI 


SECTOR # 




CYLINDER LOW 




# OF BLOCKS 




CONTROL 



256/512/1024 


E 


E 


E 





BYTES OF DATA 


C 


C 


C 







2 


1 
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WRITE SECTOR BUFFER 
This function writes one sector's worth of data 
to the controller sector buffer. No data transfer 
occurs between the controller and the drives. 



OUTPUT: 



Sequencing 
and Timing 



There are three phases to each function: 

• function initiation 

• function execution 

• function results 



To initiate a function, you select the controller 
with the Select Controller Register. Then you 
wait for Ready in the Status Register to be set. 
The In/Out bit and the Command/Data bit 
should indicate function transfer to the con- 
troller. You then write six function bytes to the 
Data Register. 

If the Ready is set after this transfer, either 
there was an error in the function bytes or the 
controller is ready to receive another group of six 
function bytes and/or data. 
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Data can be transferred in DMA or non-DMA 
mode. If the transfer is in DMA mode, the DMA 
Controller is programmed in Single Transfer 
mode (See DMA Controller). The count word is 
set to: 

(number of sectors to transfer)(bytes/sector) - 1 

If data is transferred in non-DMA, you use 
Ready, In/Out, Command/Data and Interrupt 
Request to time the transfer during execution. 

Execution begins when the last function byte is 
received. In data transfer functions, the con- 
troller temporarily stores the data in the sector 
buffer. This prevents data overruns. When the 
function completes and the Completion Status 
byte is loaded, the controller issues interrupts if 
requested. 

You clear the Interrupt Enable and the DMA 
enable bits in the Control Register after reading 
the Completion Status. This allows the con- 
troller to clear Interrupt Request and Data 
Request in the Status Register. It also clears the 
Selected bit. 

The controller does extensive error recovery. If 
an error is found, four retries are attempted. If a 
retry is successful, the error is not reported; how- 
ever, the retry count is incremented. 

The following errors result in a retry: 

• Seek error 

• Sector not found 

• Uncorrectable data error 
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Correctable data error 
No data address mark 
No ID address mark 
ECC error in ID field 

On a seek error, a recalibrate and reseek is done 
by the controller. 

The following errors are accumulated in the log: 

ECC error in ID field 
Correctable error in data field 
Uncorrectable error in data field 
No ID address mark 
No data address mark 
Seek error 
Record not found 

If rereads are disabled, the controller does not 
reread before applying the ECC correction. 

When a reset is done, the controller defaults to 
the following characteristics: 

Maximum number of cylinders = 306 
Maximum number of heads = 4 
Starting reduced write current cylinder = 306 
Starting write precompensation cylinder = 
Maximum ECC data burst length = 4 bits 
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The interleave factor states how many physical 
sectors logical sectors are apart. For example, if 
the Interleave Factor is 6 and there are 16 sec- 
tors in a track, then a sector looks like this: 

Physical 

Sector 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 
Logical 

Sector 3 6 9 12 15 1 4 7 10 13 16 2 5 8 11 14 



The track layout for 256 bytes per sector, 33 sec- 
tors per track is: 



13 


a 


F 


c 


h 


s 


e 








13 


a 


F 


256 


e 








10 


bytes 


m 


E 


y 


d 


e 


c 








bytes 


m 


8 


bytes 


c 








bytes 


OO's 






1 




c 


c 






OO's 






data 


G 






4E's 



am, FE, cyl, hd, sec, 00, F8 = 1 byte 
ecc = 3 bytes 



Track capacity = 10416 

16 = Index Gap (4E) 
10197 = 33 sectors @ 309 bytes/sector 

203 = Speed Tolerance Gap (4E) 
10416 

309 bytes/sector including ID and overhead 



The track layout for 512 bytes per sector, 17 sec- 
tors per track is: 



13 


a 


F 


c 


h 


s 


e 








13 


a 


F 


512 


e 








37 


bytes 


m 


E 


y 


d 


e 


c 








bytes 


m 


8 


bytes 


c 








bytes 


OO's 






1 




c 


c 






OO's 






data 


c 






4E's 



am, FE, cyl, hd, sec, 00, F8 = 1 byte 
ecc = 3 bytes 
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Track capacity = 10416 

16 = Index Gap (4E) 
10064 = 17 sectors @ 592 bytes/sector 

336 = Speed Tolerance Gap (4E) 
10416 

592 bytes/sector including ID and overhead 



The track layout for 1024 bytes per sector, 9 sec- 
tors per track is: 



13 


a 


F 


c 


h 


s 


e 








13 


a 


F 


1024 


e 








58 


bytes 


m 


E 


y 


d 


e 


c 








bytes 


ni 


8 


bytes 


c 








bytes 


OO's 






1 




c 


c 






OO's 






data 


c 






4E's 



am, FE, cyl, hd, sec, 00, F8 = 1 byte 
ecc = 3 bytes 



Track capacity = 10416 

16 = Index Gap (4E) 
10125 = 9 sectors @ 1125 bytes/sector 

275 = Speed Tolerance Gap (4E) 
10416 

1125 bytes/sector including ID and overhead 
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Sample 
Program 



INIT_CTLR 

This routine prepares the controller to 
receive a function. 

OUTPUT: Carry set if error 
SELECT EQU 322 

STATUS EQU 321 

CONTROL EQU 323 



INIT-CTLR: 




MOV DX,SELECT 


;Select Port Address 


OUT DX,AL 


;Output anything 


MOV DX,CONTROL 


;Control Port Address 


MOV AL,3H 


;Enable interrupts and 




;DMA 


OUT DX,AL 




MOV DX,STATUS 


;Status Port Address 


INITl: 




IN AL,DX 


;Get status 


TEST AL,1H 


;Is it ready? 


LOOPZ INITl 


;Loop if not ready 


CMP AL,DH 


; Jump if ready for a 


JE INIT2 


;function and selected 


STC 


;Flag error 


RET 




INIT2: 




CLC 




RET 
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Functional The keyboard interface converts the parallel 
Description data into serial data for transmission to and 
from the keyboard. 

To provide maximum flexibility in defining key- 
board operations, the keyboard uses scan codes 
rather than ASCII codes. In addition, all keys 
generate a make scan code when pressed and a 
break scan code when released. The break scan 
code is 80H plus the make scan code. 

The keyboard is responsible for keeping track of 
the amount of time a key is depressed and for 
generating the repeat key signal. All the keys 
have this repeat function. 



Block 
Diagram 



PA4 - 
PAS - 



1 



► 

♦5V-0 



OLQOK 



-KEYBOARD CLOCK 
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Keyboard 
Interface 



Registers 

PORT NAME 



60 



60 
60 
64 



DATA 



DATA 

CONTROL 

STATUS 



READ/ 
WRITE 

R 



W 
R/W 
R 



DESCRIPTION 



8 bit scan code when pressed, 8 bit 
scan code plus 80H when released 
See scan code chart. 
Keyboard command codes 
See layout 
See layout 
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Functions • READ STATUS 

This function allows you to determine when 
there is a character to read and when the key- 
board is ready to receive a character. 
INPUT: STATUS 

• READ DATA 

This function allows you to read the scan code of 
the key that was pressed or released. 
INPUT: DATA 

• WRITE CONTROL 

This function allows you to issue control com- 
mands to the keyboard. 
OUTPUT: CONTROL 
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• GET KEYBOARD TYPE 

This function determines if the keyboard is an 
OHvetti M20 type keyboard. 
OUTPUT: DATA REGISTER 

5 

INPUT: DATA REGISTER 

1 = OHvetti M20 keyboard 

• KEYBOARD LEDS 

This function controls the illuminations of the 
CAPS LOCK and NUM LOCK LEDS. 
OUTPUT: DATA REGISTER 
13H 



Value 


Operation 


OOh 


No operation 


Olh 


Cap lock LED OFF 


02h 


Num lock LED OFF 


03h 


Both LEDS OFF 


80h 


No operation 


81h 


Caps lock LED ON 


82h 


Num lock LED ON 


83h 


Both LEDS ON 



Any other value will cause one of the above 
operations. 
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Scan Codes 



KEY NO 


SCAN CODE 


KEY NO 


SCAN CODE 


KEY NO 


SCAN CO 


1 


OIH 


36 


24H 


71 


47H 


2 


02H 


37 


25H 


72 


48H 


3 


03H 


38 


26H 


73 


49H 


4 


04H 


39 


27H 


74 


4AH 


5 


05H 


40 


28H 


75 


4BH 


6 


06H 


41 


29H 


76 


4CH 


7 


07H 


42 


2AH 


77 


4DH 


8 


08H 


43 


2BH 


78 


4EH 


9 


09H 


44 


2CH 


79 


4FH 


10 


OAH 


45 


2DH 


80 


50H 


11 


OBH 


46 


2EH 


81 


51H 


12 


OCH 


47 


2FH 


82 


52H 


13 


ODH 


48 


30H 


83 


53H 


14 


OEH 


49 


31H 


84 


54H 


15 


OFH 


50 


32H 


85 


55H 


16 


lOH 


51 


33H 


86 


56H 


17 


IIH 


52 


34H 


87 


57H 


18 


12H 


53 


35H 


88 


58H 


19 


13H 


54 


36H 


89 


59H 


20 


14H 


55 


37H 


90 


5AH 


21 


15H 


56 


38H 


91 


5BH 


22 


16H 


57 


39H 


92 


5CH 


23 


17H 


58 


3AH 


93 


5DH 


24 


18H 


59 


3BH 


94 


5EH 


25 


19H 


60 


3CH 


95 


5FH 


26 


lAH 


61 


3DH 


96 


60H 


27 


IBH 


62 


3EH 


97 


61H 


28 


ICH 


63 


3FH 


98 


62H 


29 


IDH 


64 


40H 


99 


63H 


30 


lEH 


65 


41H 


100 


64H 


31 


IFH 


66 


42H 


101 


65H 


32 


20H 


67 


43H 


102 


66H 


33 


21H 


68 


44H 


103 


67H 


34 


22H 


69 


45H 


104 


68H 


35 


23H 


70 


46H 
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Sequencing To send a character to the keyboard, wait for Bit 
and Timing 1 of the Status Register to be set and write the 
byte to the data register. 

To receive a character, wait for Bit of the Sta- 
tus Register to be set and read the character. 
The keyboard interface can be programmed to 
interrupt on INTl when there is a character to 
read. 



Sample ;This program sets the GAPS LOCK LED 
Program STATUS EQU 64 

DATA EQU 60 

SET_LED: 



IN AL,STATUS 
TEST AL,2 
JNZ SET_LED 
MOV AL,013H 
OUT DATA,AL 

SETl: 
IN AL,STATUS 
TEST AL,2 
JNZ SETl 
MOV AL,81 
OUT DATA,AL 
RET 



;read status 

;keyboard ready to receive 
;input? Jump if ready. 
;keyboard LED command 



;read status 

;ready to receive input? 

;jump if not 

;CAPS LOCK 

;write out code 
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Functional The parallel printer interface connects to print- 
Description ers with a Centronics-like parallel interface or 

any other device with identical interface charac- 
teristics. The input and output signals are pre- 
sented to the external device through a 25-pin 
"D" type connector. 



Block 
Diagram 



The interface has 5 buffered outputs — data, 
strobe, initialize printer, automatic linefeed, and 
select. These can be read and written. In addi- 
tion, the interface has five inputs — acknowl- 
edge, busy, paper out, error and select. An inter- 
rupt can be enabled on INTV. 



■lOWR - 
■lORD 
-PNTRCS- 
AO 



PECOOER 




Registers 



INTERRUPT - 
■ N -BL L • 



PORT# 



NAME 



378 DATA 

379 STATUS 
37A CONTROL 



READ/ 
WRITE 

R/W 

R 
R/W 



DESCRIPTION 



Print character 
See layout 
See layout 
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9-101 
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Functions • RESET 

After a power on or a hardware reset, the data 
buffer is cleared and the control register is 
initialized to: 

bit 0: 
bit 1: 
bit 2: 
bit 3: 
bit 4: 

• WRITE DATA 

This instruction enables the data on the data 
bus to be written to the printer data bus. The 
actual writing occurs when the strobe line is 
activated. 
OUTPUT: DATA 

• WRITE CONTROL 

This instruction inverts DO, Dl, and D3 on the 
data bus and writes the data to the control regis- 
ter. If D4 is a 1 then interrupts are requested. 
OUTPUT: CONTROL 

• READ DATA 

This instruction enables the data on the printer 
data bus to be read onto the data bus. It normal- 
ly is the last character written to the printer. 
INPUT: DATA 

• READ CONTROL 

This instruction enables the data on the printer 
control lines and the interrupt control bit to be 
placed on the data bus. 
INPUT: CONTROL 

• READ STATUS 

This instruction enables the data on the printer 
status lines to be placed on the data bus. 
INPUT: STATUS 
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Sequencing To send a character to the printer, the character 
and Timing is put on the data bus. When the printer is not 

busy, it is ready to accept the next character. 

The character must be strobed into the printer 

by setting the strobe bit to 1 for at least 5 //- 

seconds and then resetting it. 

Interrupt can be enabled on INT7 by writing D4 
= 1 in the control register. An interrupt will be 
triggered everytime Bit 6 of the status register 
goes from to 1 (end of the acknowledge cycle 
from the printer). 

To initialize the printer, first select it. Then issue 
the initialize command setting the automatic 
line feed and interrupt parameters. 
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Sample 
Program 



PRINT_CHAR 

Send character to printer and get status 
INPUT AL - character to print 
OUTPUT: AL- status 

DATA EQU 378H 

PRINT.CHAR: 

MOV DX,DATA ;get data port 

OUT DX,AL 



INC DX 

IN AL,DX 

TEST AL,080H 

JNZ PRINT_NOT_BUSY 



;put char on data 
;Hne 

;get status port 
;read in status 
;is the printer busy? 
;jump if not busy 



PRINT_NOT_BUSY: 
MOV AL,ODH 
INC DX 
OUT DX,AL 
NOP 
NOP 

MOV AL,OCH 
OUT DX,AL 
DEC DX 
IN AL,DX 
RET 



; strobe high 
;get control port 
;to control register 
;wait 
;wait 

;strobe low 
;to control register 
;get status port 
;read in status 
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Functional The Intel 8259A Programmable Interrupt Con- 
Description troUer (PIC) manages external interrupts. It 
receives requests from peripheral equipment, 
decides which request has the highest priority, 
and issues an interrupt to the CPU. Each PIC 
handles 8 maskable priority interrupts. PIC's 
can be cascaded allowing up to 64 priority inter- 
rupts. However, on the AT&T Personal Comput- 
er 6300 this is not done. 



Each interrupt device runs to one of eight inter- 
rupt lines (INT0-INT7). If more than one device 
interrupts at once, the PIC decides which device 
to service according to one of several schemes. 

The following schemes apply to a single PIC: 

• Fully Nested Mode 

This is the default mode. The interrupt requests 
have an ordered priority from (highest) to 7 
(lowest). The highest priority is acknowledged 
first and those of lower priority are inhibited. 



• Special Mask Mode 

This mode is similar to fully nested mode except 
that the interrupt mask register (IMR) deter- 
mines which interrupts are disabled. 



• Polled 

This mode allows the CPU to poll the devices. It 
is selected by disabling interrupts with the CLI 
instruction. Periodically the CPU polls the PIC 
to receive the interrupt type of the highest prior- 
ity device requesting service. 
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• Automatic Rotation 

In this mode, a device receives the lowest prior- 
ity after it is serviced. All other devices have 
their priorities adjusted accordingly. The next 
highest interrupt line receives the highest 
priority. 

• Programmable Rotation 

In this mode, the programmer declares the low- 
est priority device. 

The PIC keeps track of devices that are waiting 
for service in the interrupt request register (IRR). 
If not in polled mode, the PIC notifies the CPU 
of the pending interrupt. When it receives an 
interrupt acknowlege from the CPU (INTA), it 
sends the interrupt type of the device to the 
CPU. The device is then in-service. This is noted 
in the in-service register (ISR). The type of INTO 
is programmable. It must be a multiple of 8. 

After the interrupt service routine services the 
interrupt, it notifies the PIC of end of interrupt 
(EOI). The device is then removed from the in- 
service register. 



Block 
Diagram 



-lOWR — ■^0 



17 



■ INTERNAL BUS 
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Registers 



PORT# 



NAME 



READ/ 
WRITE 



DESCRIPTION 



20 INIT COMMAND WORD 1 (ICWl) 

21 INIT COMMAND WORD 2 (ICW2) 

21 INIT COMMAND WORD 3 (ICW3) 
21 INIT COMMAND WORD 4 (ICW4) 
21 OPERATION COMMAND WORD 1 

(OCWl, IMR) 
20 OPERATION COMMAND WORD 2 
(0CW2) 

20 OPERATION COMMAND WORD 3 
(0CW3) 

20 IN-SERVICE REGISTER (ISR) 

21 INTERRUPT LEVEL 

20 INTERRUPT REQUEST REGISTER 
(IRR) 



W See layout 

W INTO interrupt type, 

multiple of 8 
W Cascade mode only 
W See layout 
R/W Interrupt Mask 
Register 
See layout 
See layout 



W 

W 

R 
R 
R 



See layout 

See layout 
See layout 
See layout 
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OCWl or INTERRUPT MASK REGISTER 



INT7 cHsjabiefi 



INT6 disabled 



INTS disabted 



]NT4 disabled 



INT3 disabled 



INT2 disabled 



INT1 disabled 



INTO disabled 





fNT6 enal}ted 



INtS enabled 



tNT4 enabled 



INTS enabled 



INT2 enabled 



INT1 enabled 



INTO enabled 



6 



01; miispec^ £01 * ' - . 'I 
XhtKX^jerstion" -•'* , 'I 
1 1: 5pei^c eoU'Sits 0^ iomsi I 
■priority ■ : : : ' 
1Qa9«trotat{ofttn«d» - . -- * * J 



interrupt level (0-7) 
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Functions • INITIALIZATION 

This function prepares the PIC to accept inter- 
rupts by setting it to an initial state. 
OUTPUT: ICWl 
ICW2 

ICW3 (Cascaded PIC's only) 
ICW4 

• SET SPECIAL MASK MODE 

This function sets the priority scheme to Special 
Mask Mode. The Interrupt Mask Register (IMR) 
defines enabled priorities. 

OUTPUT: 0CW3 BITS 5-6 = 3 
IMR 

• RESET SPECIAL MASK MODE 

This function resets the priority structure to the 
Fully Nested Mode. The IMR is ignored. 
OUTPUT: 0CW3 BITS 5-6 = 1 

• SET POLLED MODE 

This function sets the priority scheme to Polled 
Mode. The CLI instruction must be executed to 
disable external interrupts. The next read 
fetches the interrupt level. 

OUTPUT: 0CW3 BIT 2 = 1 

INPUT: interrupt level 

• AUTOMATIC ROTATION OF PRIORITIES 
ATEOI 

This function requests an automatic rotation of 
priorities at EOI. 

OUTPUT: ICW2 BITS 5-7 = 5 

• PROGRAMMED ROTATION AT EOI 

This function requests a specific change in prior- 
ities at EOI. 

OUTPUT: ICW2 BITS 5-7 = 7 

ICW2 BITS 0-2 = level of lowest 
priority 
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• ROTATION OF PRIORITIES INDEPENDENT 
OF EOI 

This function requests an immediate change in 
priorities. 

OUTPUT: 0GW2 BITS 5-7 = 6 

0CW2 BITS 0-2 = level of lowest 
priority 

• SPECIFIC END OF INTERRUPT (SEOI) 
This function is issued in an interrupt service 
routine to declare end of interrupt service for the 
specified level. 

OUTPUT: 0CW2 BITS 5-7 = 3 

BITS 0-2 = interrupt level 

• NON-SPECIFIC END OF INTERRUPT (EOI) 
When the PIC is operating in Fully Nested 
Mode, it can determine which interrupt is com- 
pleting. This function signals completion of an 
interrupt service routine. 

OUTPUT: 0CW2 BITS 5-7 = 1 

• AUTOMATIC END OF INTERRUPT 

This function requests the PIC to declare end of 
interrupt automatically after delivering the 
interrupt to the CPU. 

OUTPUT: ICW4 BIT 1 = 1 

• READ IRR 

This function reads the devices requesting 
service. 

OUTPUT: 0CW3 BITS 0-1 = 2 
INPUT: IRR 

• READISR 

This function reads the in-service register. 
OUTPUT: 0CW3 BITS 0-1 = 3 
INPUT: ISR 



9-113 



Programmable 
Interrupt Controller 



• READ IMR 

This function reads the interrupt mask register. 
INPUT: OCWl 



Sequencing When the ICWl command is issued, the initiah- 
and Timing zation process begins. The following automati- 
cally occurs: 

• IMR is cleared. 

• INT7 is assigned the lowest priority. 

• Single mode is assumed. 

• Special Mask Mode is cleared. 

• A status read fetches IRR. 

• If Bit equals zero, then ICW4 functions are set 
to zero. 

Next ICW2 is output. ICW3 is skipped in all sin- 
gle PIC systems. If the ICW4 was requested by 
ICWl then it is output. This completes 
initialization. 

Once the initialization process is complete, the 
PIC is ready to accept interrupts. Any of the 
functions to change the priority scheme can be 
executed. In addition, the IRR, IMR, and ISR 
can be read. 

If automatic EOI is not specified then the inter- 
rupt service routine must declare EOI. Either 
specific or non-specific EOI can be used depend- 
ing on the priority scheme in use. 
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When a write command is issued to the PIC, 480 
nanoseconds must elapse before another com- 
mand is issued. In the read case, 395 nanosec- 
onds must elapse. 



Sample 
Program 



SEND_SEOI 

Send end of INTl service at the end of the 
interrupt service routine. 

0CW2 EQU 20 ;port address of 0CW2 

COMMAND EQU 61 ;6 = SEOI, 1 = INTl 



SEND_SEOI: 
MOV AL,COMMAND 
MOV DX,0CW2 
OUT DX,AL 
STI 
RET 



;set AL = command 
;set DX = port address 
;send command 
;enable external interrupts 
;retum to service routine 
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Functional The Intel 8253 Interval Timer has three identi- 
Description cal, 16-bit, settable, decrementing counters. Each 
counter is totally independent. The counters 
have either a BCD or binary value and operate 
in one of five modes: 



• Interrupt on Terminal Count 

The output remains low after the mode is set. It 
continues low after the counter is loaded until 
the counter counts down to zero. Then the output 
goes high. It remains high until a new mode is 
selected or a new count is loaded. 

• Programmable One-Shot 

The output goes low one count following the ris- 
ing edge of the gate input. The output goes high 
on the terminal count. 



• Rate Generator 

The output is low for one period of the input 
clock. The period from one output pulse to the 
next equals the number of input counts in the 
count register. 

• Square Wave Rate Generator 

The output remains low for one period of the 
input clock. The output remains high until one 
half the count has elapsed. If the count is odd, 
the output is high for (n+l)/2 and low for 
(n-l)/2. 

• Software Triggered Strobe 

After the mode is set, the output will be high. 
When the count is loaded, the counter begins 
counting. On the terminal count,the output goes 
low for one clock period and then goes high. 
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• Hardware Triggered Strobe 

The counter starts counting after the rising edge 
of the trigger input and goes low for one clock 
period when terminal count is reached. 



These timing diagrams illustrate the different 
modes. 



3.6864 
MHz 
OSC 



Z8530 


TXDB 


sec 


-RTSB 




-DTRB 




-TRXCB 


D0:7 


RXDB 


-CTSB 


-WR 


-DCDB 


-RD 


-RTXCB 




-CS 




D/-C 




A/-B 






TXDA 




-RTSA 




-DTRA 




-TRXCA 


PCLK 






RXDA 




-CTSA 


-INT 






-DCDA 




-RTXCA 



-DSR1< 
-RI1-. 



-DSRa- 
-RI2i 



1488 
LINE 
DRIVERS 



-01489 
-OUNE 
-O RECEIVERS 



TXDB 
RTSB 
DTRB 
TRXCB 



RXDB 

CTSB 

-DSR2 

-RI2 

DCDB 

RTXCB 



Z8350 CHANNEL B 
CONNECTOR 

PIN# 



TL1 
RTS 
DTR 
TXCLK 



TC 

RD 'SiS 
CTSM 
DSR'S 
Rl W 

dcdW 

RC 

INTERFACE 
CONNECTOR 



2 
4 
23 
24 



START '-"T^^op 
^ ..._L1 



MARKING LINE DATA DATA DATA MARKING LINE 



ASYNCHRONOUS 



SYNC DATA DATA CRC1 CRC2 



SYNC SYNC DATA DATA CRC1 CRC2 



SIGNAL 
I 



DATA CRG1 CRC2 



EXTERNAL SYNC 



FLAG ADOreSS INFORMATION GRC1 CRC2 FLAG 



SDLC/HDLC/X25 
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In the AT&T Personal Computer 6300 system, 
Counter provides real time interrupts on INTO, 
counter 1 requests memory refreshes, and count- 
er 2 generates a pulse train for the audio 
speaker. 



Block 
Diagram 



CONTROL 

WORD 
REGISTER 



CO 



c 



c=0 



^ CLK 2 

^ GATE 2 



^ CLK 1 

^ GATE 1 



-^0UT1 



^ CLKO 

^ GATED 

^OUTO 



TMR2GSPKR 
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Registers 

PORT # NAME READ/ 

WRITE 

40 COUNTER R/W 

41 COUNTER 1 R/W 

42 COUNTER 2 R/W 

43 CONTROL W 



DESCRIPTION 

Provides real time interrupt INTO 
Provides signals to refresh memory 
Generate pulse train for the audio 
speaker 
See Layout 



Layout 

CONTROL 

1 
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Functions « LOAD COUNTER 

This function allows you to set a specific 
counter. 

OUTPUT: CONTROL REGISTER 

BITSO binary or BCD 
BITS 1-3 mode 
BITS 4-51,2 or 3 
BITS 6-7 counter 
8 or 16 bit count value 



• READ COUNTER 

This function allows you to read a specific 
counter. 

OUTPUT: CONTROL REGISTER 

BITS 4-5 
BITS 6-7 counter 
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Sequencing 
and Timing 



All counters must be initialized with the control 
register. The control register specifies the 
number of bytes which must be loaded. 

Whenever a read or a load command is issued, 
the requested counter bytes must be read Or writ- 
ten. In the read case, two reads are necessary, 
the first for the least significant byte (LSB) and 
the last for the most significant byte (MSB). In 
the write case, the control register specifies the 
byte to write. 

1 microsecond recovery time is required between 
a read or a load and any other control signal. 

Input to the timer is 1. 2288MHz. Therefore, there 
are 18.75 interrupts per second. To generate a 
1.00 KHz tone with the audio speaker, a square 
wave rate generator is used with a count of 614 



(1.2288MHz/2*614 = IKHz). 
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Sample 
Program 



ASK_FOR_INTR 

This program requests an interrupt in 
approximately 10 usee (9765.6 nsec) 

TIMER_CONTROL EQU 43 
TIMERO EQU 40 



INTJVIASK 



EQU 21 



ASK_FOR_INTR: 

MOV AL,OFEH ;allow only INTO 

;interrupt 

OUT INT_MASK,AL ;send mask 
MOV AL,00110000B ;binary counter, 

;interrupt on terminal 
;count, set counter 

OUT TIME_CONTROL,AL 

MOV AX,12 ;12 * 813.8 nsec 

OUT TIMERO,AL 

MOV AL,AH ;output counter, LSB 

;then MSB 

OUT TIMERO,AL 
RET 
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Functional The real time clock and calendar keep the cur- 
Description rent data and time. All of the date and time 

fields can be read but the second fields cannot be 
written. The calendar keeps up to eight years. A 
rechargeable battery keeps the unit running 
even when the computer is turned off. 



Block 
Diagram 



r 
T 



T 



PR 

n Q 



CK O 
CLR 



1 



CK Q 
CLR 



OSCILLATOR 
DIVIDERS 



□83 
D82 
D81 
D80- 



VDD 
INT- 



GND 



ADS • 
AD2 - 
AD1 - 
ADO- 



APDRESS 
Df.C'ODE 



R/W 
LOGIC 



DAY 
C 

Vv'LrK 



7^ 



READ' 
WRITE 
MUX 



READ 
MUX 



1/10 
St C 



-J 10 Hz I 
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Registers 



PORT# NAME READ/ DESCRIPTION 

WRITE 



70 


TEST PORT 


W 


O=not test mode, l=test mode 


71 


1/10 OF A SECOND 


R 


nybble, 0-9 


72 


UNIT SECONDS 


R 


nybble, 0-9 


73 


lO'S OF SECONDS 


R 


nybble, 0-5 


74 


UNIT MINUTES 


R/W 


nybble, 0-9 


75 


lO'S OF MINUTES 


R/W 


nybble, 0-5 


76 


UNIT HOURS 


R/W 


nybble, 0-9 


77 


lO'S OF HOURS 


R/W 


nybble, 0-1 


78 


UNIT DAYS 


R/W 


nybble, 0-9 


79 


lO'S OF DAYS 


R/W 


nybble, 0-3 


7A 


DAY OF WEEK 


R/W 


nybble, 1-7 


7B 


UNIT MONTHS 


R/W 


nybble, 0-9 


7C 


lO'S OF MONTHS 


R/W 


nybble, 0-1 


7D 


LEAP YEAR 


W 


See layout 


7E 


STOP/START 


W 


= stop, FF = start 


7F 


INTERRUPT/YEAR 


R/W 


See layout 




MODS 
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Layout 



INTERRUPT/YEAR MOD 8 



single interrupt 



6 



repeated interrupt 



year mod 8 
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Functions • READ CALENDAR AND CLOCK 

All of the calendar and time registers are read- 
able. Those from port address 71 to 7D and 7F 
contain a nibble of data. 

• WRITE CALENDAR AND CLOCK 

All of the calendar and time registers except 
seconds are writable. The registers from port 
address 74 to 7D and 7F each contain a nibble of 
data. 



Sequencing To write data to the clock and time registers, the 
and Timing unit must be out of test mode and stopped. After 
writing to the clock, it must be restarted. 

To initialize interrupts, set Bit 4 in the Inter- 
rupt/Year mod 8 register. Write the register once 
and then read it in three times. 



If an update occurs while reading a register, the 
illegal code of F is returned. 
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and Calendar 



Sample 
Program 



SET TIME 

This routine sets the time to 12:00 noon 



TEST_PORT EQU 70 

STOP_START EQU 7E 
TENS-HOURS EQU 77 
WRITE_TIME: 

XORAX,AX 

MOV DX,TEST_PORT 

OUT DX,AL 

OUT STOP_START,AL 



;AX = 
;setup dx 
;take out of 
;test mode 
;stop the clock 



MOV DX,TENS_HOURS ;port addr of 

;10's of hours 

MOV AL,1 
OUT DX,AL 



DEC DX 
MOV AL,2 
OUT DX,AL 

DEC DX 
XOR AL,AL 
OUT DX,AL 

DEC DX 
OUT DX,AL 

MOV AL,OFFH 

OUT STOP_START,AL 



;ten's of hours 

;=i 



;unit hours = 2 
;tens of minutes 

;=o 

;minutes = 
;start the clock 



RET 
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Functional Z8530 Serial Communications Controller (SCC) 
Description performs serial-to-parallel conversion on input 
data characters received from a modem and 
parallel-to-serial conversion on output data 
characters received from the CPU. It supports 
the following common asynchronous and syn- 
chronous data communication protocols. 



-lO WR 

-lORD 

-853 0CS 

AO 

A1 



3.6864 
MHz 
OSC 



INTERRUPT 
ENABLE 



Z8530 
SCC 



-WR 
-RD 
-OS 
D/-C 
A/-B 



TXDB 
-RTSB 
-DTRB 
■TRXCB 



RXDB 
-CTSB 



-DCDB 
-RTXCB 



TXDA 
-RTSA 
-DTRA 
-TRXCA 



RXDA 
-CTSA 



-DCDA 
-RTXCA 



-DSR1< 
-RI1< 



-DSR2- 
-R\2< 



1488 
LINE 
DRIVERS 



O RECEIVERS 



TXDB 
RTSB 
DTRB 
TRXCB 



RXDB 

CTSB 

-DSR2 

-RI2 

DCDB 

RTXCB 



ZO 350 CHANNELS 
CONNECTOR 

|PIN# 



TD 
RTS 
DTR 
TXCLK 



TC 

RD 

CTS 

DSR 

Rl 

DCD 
RC 



2 
4 

24 



INTERFACE 
CONNECTOR 



START PARITY 



MARKING LINE DATA 



SYNC DATA 



SIGNAL 



DATA MARKING LINE 



ASYNCHRONOUS 



DATA 



DATA CRC1 CRG2 



MONOSYNC 



SYNC SYNC DATA 



DATA CRC1 CRC2 



BISYNC 



DATA CRCl CRC2 



EXTERNAL SYNC 



FLAG ADDRESS INFORMATION 



GRC1 CRC2 FLAG 



SDLC/HDLC/X25 
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In addition, the SCC supports five encoding 
methods - NRZ, NRZI, FMl (bi-phase mark), 
FMO (bi-phase space), and Manchester (bi-phase 
level). 



Figure 20 



MANCHESTER 
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The sec has the following capabilities: 

Asynchronous 

• 5, 6, 7, or 8 bits per character 

• 1, 11/2, or 2 stop bits 

• Odd or even parity 

• Times 1, 16, 32, or 64 clock modes 

• Break generation and detection 

• Parity, overrun and framing error detection 

Byte-oriented synchronous 

• Internal or external character synchronization 

• 1 or 2 sync characters in separate registers 

• Automatic sync character insertion and deletion 

• Cyclic redundancy check (CRC) generation/ 
detection 

• 6- or 8-bit sync character 

SDLC/HDLC 

• Abort sequence generation and checking 

• Automatic zero insertion and deletion 

• Automatic flag insertion between messages 

• Address field recognition 

• I-field residue handling 

• CRC generation/detection 

• SDLC loop mode with EOF recognition/loop 
entry and exit 

, The baud rate is programmable for both 

channels. 

Registers 

PORT# NAME READ/ DESCRIPTION 

A B WRITE 

51 53 DATA R/W Transfer data 

50 52 sec REGISTER POINTER R/W Transfer SCC register number 

and SCC register data 
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sec Registers 

READ/ NO NAME DESCRIPTION 



W XVI ill/ 








it 


U 


Buiier and External Status 


See layout 


it 


i 


Special Receive Condition Status 


O 1 i 

oee layout 


n 


o 

z 


Modified Internipt Vector (Channel B) 








Unmodified Interrupt Vector (Channel A) 




Xx 


o 


Interrupt Pending Bits (Channel A) 


See layout 


■R 

n 


Q 
O 


Receive Buffer 


See layout 


it 


1 n 
iU 


Miscellaneous Status 


See layout 


it 


1 


Low Byte of Baud Rate Generator Constant 




it 


1 Q 


High Byte of Baud Rate Generator Constant 




it 


iO 


External/Status Interrupt Information 


See layout 


w 

VV 


A 

u 


Uitu initialize 


See layout 


w 


-I 

i 


Transmit/Receive Interrupt and Data Transfer 








Mode Definition 


See layout 


w 
w 


o 

z 


Interrupt Vector 




W 


3 


XVC^^CiVC X cXLcXLllKiVCLb dXlLl V^UlllXUl 


oee layout 


W 


4 


Transmit/Receive Miscellaneous Parameters 








and Modes 


See layout 


W 


5 


Transmit Parameters and Control 


See layout 


W 


6 


Sync Characters or SDLC Address Field 


See layout 


W 


7 


Sync Characters or SDLC Flag 


See layout 


W 


8 


Transmit Buffer 


See layout 


W 


9 


Master Interrupt Control and Reset 


See layout 


W 


10 


Miscellaneous Transmit/Receive 








Control Bits 


See layout 


W 


11 


Clock Mode Control 


See layout 


W 


12 


Low Byte of Baud Rate Generator Constant 




W 


13 


High Byte of Baud Rate Generator Constant 




W 


14 


Miscellaneous Control Bits 


See layout 


W 


15 


External/Status Interrupt Control 


See layout 
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WRITE REGISTER 6 





M0N0,8 BITS 


M0N0,16 BITS 













SYNCO 


SYNCO 


o I IN UU 


1 

1 


AUixV 


Y 
A 


1 


SYNCl 


SYNCl 




1 


AJJXVl 


V 
A 


2 


SYNC2 


SYNC2 


O X IN L/Z 


1 


A ■r\"Do 


V 

A 


3 


SYNC3 


SYNCS 


& I IN L/O 


1 


A T^'DO 
AUKd 


V 

A 


4 


SYNC4 


SYNC4 


1 IN U4 


GVMPn 

OlIMUU 


A T^X> A 

AUK4 


AUK4 


5 


SYNCS 


SYNCS 




QVMr'1 

13 I INOi 


AUXvO 


AJJxvO 


6 


SYNC6 


SYNCO 


SYNC6 


SYNC2 


ADR6 


ADR6 


7 


SYNC7 


SYNCl 


SYNC7 


SYNC3 


ADR7 


ADR7 


WRITE REGISTER 7 












M0N0,8 BITS 


M0N0,16 BITS 


BISYNC,16 BITS 


BISYNC,12 BITS 


SDLC 







SYNCO 


X 


SYNCS 


SYNC4 







1 


SYNCl 


X 


SYNC9 


SYNCS 


1 




2 


SYNC2 


SYNCO 


SYNCIO 


SYNC6 


1 




3 


SYNC3 


SYNCl 


SYNCH 


SYNC? 


1 




4 


SYNC4 


SYNC2 


SYNC12 


SYNCS 


1 




5 


SYNC5 


SYNCS 


SYNCIS 


SYNC9 


1 




6 


SYNC6 


SYNC4 


SYNC14 


SYNCIO 


1 




7 


SYNC7 


SYNCS 


SYNCIS 


SYNCH 
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i.ii-i-jN.;,-'-. '<.:■ ■'■ ' ' 



WRITE REGISTER 9 





No Reset 



Status in High Bits of Vector 



01: Reset Channel B 
10: Reset Channel A 
11: Reset Both Channels 



Status in Low Bits of Vector 



IVIaster Interrupt Enable 



Disable Lower Cham 



No Vector 



Vector Includes 3 Bits of Status 



WRITE REGISTER 10 




■■IHiliB 

■■■■iililH 



NRZ 



Transmit Sends Flags in Idle State 



6-Bit Sync 



Preset CRC Generator Checker 

iilllSiiiiiliiiililSillSIl 



01: NRZI 
10: FM1 
11: FMO 



Go Active on Poll 



Transmit Sends Continuous 1's in 
Idle State 



On Underrun. Send Abort and Flag 
Instead of CRC and Flag (SDLC) 

Loop Mode 



8-Bit Sync 
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WRITE REGISTER 11 




RTxC Pm Input is TTL Compatible' 



Receive Clock = -RTxC Pin 



Transmit Clock = -RTxC Pin 



-TRxC Pin IS Input 



-TRxC Pin Out - Xtal Output 



6 



HHIIHIHI 



01 : Receive Ctoofc = -Ti^xC Ptk ^ 
10: Receive Clock » 8atf< Rat& 

Generator Output ' ; 
1 1 : Receive Clock - W^,, ,S(.v*iii 
Output - "'ri^ 



01 : Transmit Clock = -TRxC Pin 
10' Transmit Clock = Baud Rate 

Generator Output i 
1 1 : Transmit Clock = DPLL ( 

Output i 



-TRxC Pin is Output 



01 -TRxC Pin Out ^ Transmit 

ClOCK 

10 -TRxC Pin Out - Baud Rate 

Generator Output 
1 1 . -TRxC Pm Out - DPLL Output 



WRITE REGISTER 14 




Null Command 



-DTR/-REQ Pin Follows State of 
DTR 



6 



1 



01 . Enter Search Mo<iei><L 
10: Reset Miss^ CaoiiieJ 
11 Disable DPLL • ■" ' 
100 Sot DPLL Clock : 
Baud Rate GiMieb^. 

.1G1 Set DPLL Clock 
-RTxC or Crystal 
rn Set DPLL FMMddtllv 
1 1 1 : Set DPLL NftZf 




Transmitter Connected to 
Receiver and Transtnits Otit 



'Transmitter Connected to Re- 
ceiver as m Local Loopback but 
Receiver Listens to Input 



-DTR/-REQ Pin Equals When 
Transmit Buffer Empty 



Baud Rate Generator Source 



Baud Rate Generator Enable 
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Functions • READ DATA 

This function reads character data. 
INPUT: DATA 

• READ sec REGISTERS 

This function reads Read Register 0-15. 
OUTPUT: sec REGISTER POINTER = 
register # 

INPUT: see REGISTER POINTER = data 

• WRITE DATA 

This function writes character data. 
OUTPUT: DATA 

• WRITE see REGISTER 

OUTPUT: see REGISTER POINTER = 
register # 

OUTPUT: see REGISTER POINTER = data 
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Sequencing The SCC has direct addressing for the data reg- 
and Timing ister only. To access the other SCC registers, 

first write the register number to the SCC Regis- 
ter Pointer and then read or write the register 
using the SCC Register Pointer. 

The SCC can operate in three basic modes to 
transfer data, status and control information: 



• polling 

• interrupt 

• block 



The block mode is not used on the AT&T Per- 
sonal Computer 6300. 

In the polling mode. Receive Character Availa- 
ble and Transmit Buffer Empty in Read Register 
are examined before receiving and sending a 
character. All interrupt functions must be dis- 
able. To do this, clear the Master Bit Enable and 
set the No Vector bit in Write Register 9. Then 
clear Write Register 1. This disables specific 
types of interrupts. 

For interrupt mode, the Master Interrupt Enable 
in Write Register 9 must be set. In addition, bits 
3-4 in Write Register 1 specify interrupts on 
receive character conditions. Bit 1 in Write Reg- 
ister 1 enables interrupts on Transmit Buffer 
Empty. Bit enables External/Status interrupt. 
This interrupt is caused by transmit underrun 
condition, a zero count in the baud rate genera- 
tor, a break detection (Asynchronous Mode), 
Abort (SDLC Mode), or EOP (SDLC Loop Mode). 
Write Register 15 enables or disables more spe- 
cific types of interrupts. 
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Interrupt sources have the following priority: 



Receive Channel A 
Transmit Channel A 
External/Status Channel A 
Receive Channel B 
Transmit Channel B 
Receive Channel B 

A bit in Read Register 3 is set to indicate the 
highest priority device needing service. You can 
read the vector address of the interrupt service 
routine in Read Register 2 if it was programmed. 
If this vector is read on Channel B, it includes 
status bits. Vectors are initialized with Write 
Register 2. The interrupt service routine resets 
the Highest Interrupt Under Service in Write 
Register 0. Other interrupts are reset in Write 
Register 0. 

To set the baud rate, first clear bits 0-1 in Write 
Register 14. Then load Write Register 12 and 13 
with the time constant. Last set bit 0-1 in Write 
Register 14 to enable the baud rate generator. To 
use the baud rate, set the transmit and receive 
clocks in Write Register 11 to the baud rate 
generator. 

To determine the time constant to use for a 
given baud rate, use this formula: 

3,686,400 .2 = Time Constant 

(16)(2)(Baud Rate) 

The following table states the divisors to use to 
obtain a given baud rate. 
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BAUD RATES USING 3.6864 MHZ CLOCK 
BAUD RATE TIME CONSTANT 



In Asynchronous mode, you initialize: 

Write Register 1 to disable DMA transfers and to 
enable or disable interrupts, 

Write Register 3 to set Receive Enable and the 
number of bits per receive character, to disable 
synchronous functions, and to enable or disable 
Auto Enable, 

Write Register 4 to set parity, stop bits, and data 
rate, and to disable synchronous mode. 

Write Register 5 to set Transmit Enable and the 
number of bits per transmit character, to enable 
or disable Request to Send, Data Terminal 
Ready and Send Break, and disable synchro- 
nous functions. 

Write Register 9 to force a reset and set interrupt 
parameters, 

Write Register 10 to choose an encoding method, 

Write Register 11 to select clock sources. 

Write Register 12 and 13 to set the baud rate 
time constant, and 

Write Register 15 to enable the baud rate 
generator. 



110 
150 
300 
600 
1200 
2400 
4800 
9600 



1045 
766 
382 
190 
94 
46 
22 
10 
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To transmit a character, wait for Transmit 
Buffer Empty to be set in Read Register 1 of the 
sec. Then write the character to the Data 
Register. 

To receive a character, wait for Receive Charac- 
ter Ready in the Read Register 1 of the SCC. 
Then read the character from the Data Register. 

In synchronous mode, you must transfer the 
data using interrupts. The External/Status 
interrupt is used to monitor the status of Clear to 
Send and Transmit Underrun/EOM latch. 

In bisynchronous mode, you initialize: 

• Write Register to reset Transmit Under- 
run/EOM Latch, receive CRC checker, external/ 
status interrupts, and enable interrupts on next 
receive character, 

• Write Register 3 to enable the receiver, and to 
program Sync Character Load Inhibit, Enter 
Hunt For Sync Character, and number of bits 
per receive character, 

• Write Register 4 to set parity, enable sync 
modes, number of bits per sync character, and 
clock mode, 

• Write Register 5 to enable Transmit CRC, to 
request 16-bit CRC polynomial, enable transmit, 
transmit 8 bits per character, and to set Data 
Terminal Ready and Request to Send, 

• Write Register 6 and 7 to set the sync bytes, 

• Write Register 9 first to reset the hardware and 
later to set interrupts and vector variables, 
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• Write Register 10 to set length of sync character, 
the encoding method, to preset the CRC genera- 
tor and to set the loop mode and go active on 
poll if wanted, 

• Write Register 11 to set the clock sources, and 

• Write Register 15 to set interrupt enable 
conditions. 

The monosync transmitter is initialized as a 
bisynchronous transmitter with two exceptions: 

• Only one sync character is written, and 

• The 6-bit or 8-bit selection in Write Register 10 
must be made. 

In SDLC mode, you initialize: 

• Write Register to reset the transmit CRC gen- 
erator after transmit enable has been done and 
to enable interrupts, 

• Write Register 1 to enable interrupts, 

• Write Register 3 to select bits per receive charac- 
ter, to set address search mode, to enable CRC 
receiver and receive enable, 

• Write Register 4 to set SDLC mode before any- 
thing else is initialized and later to set clock 
mode, 

• Write Register 5 to select the SDLC-CRC poly- 
nomial, to set Request to Send, Data Terminal 
Ready, transmit character length, transmit en- 
able, and transmit CRC enable 

• Write Register 6 to contain the secondary 
address field. 
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• Write Register 7 to contain flag character 
01111110, 

• Write Register 9 to reset the hardware and to set 
interrupt parameters, 

• Write Register 10 to set loop mode. Go Active on 
Poll, Mark/Idle Flag, Abort on Underrun, the 
CRC preset condition, and the encoding mode, 

• Write Register 11 to set clock sources, 

• Write Register 14 to set the clock source for the 
DPLL, and 

• Write Register 15 to set interrupt enable 
condition. 



Sample 
Program 



RECEIVE 

This routine receives one character 



PTER EQU 50 

DATA EQU 51 
RECEIVE: 

MOV DX,PTER 

XOR AL,AL 

OUT DX,AL 
RECl: 

IN AL,DX 

TESTAL,1 

JZ RECl 

MOV DX,DATA 

IN AL,DX 

RET 



;Pointer Port Address 
;AL = 

; Select Read Register 

;Get Read Register 
;Receive character available 
;Jump if no character 
;Data Port Address 
;Read character 
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Functional The speaker uses a permanent magnet speaker 
Description which is driven by one of two sources. Counter 2 



of the Interval Timer can be programmed to 
automatically generate a pulse train. A bit in the 
Keyboard Control Register controls this pulse 
train. A bit in the Keyboard Control Register 
can also be programmed to manually generate a 
pulse train. 



Block 
Diagram 



P ORT B PD5 



SPKRDATA 



D1, PORT ADDRESS G1 



TMR2GSPKR 



1.2288 MHz 



DO, PORT ADDRESS 61 



GATE2 



CLK2 



OUT2 



T 



AUDIO 



-5V 
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Registers 

PORT # NAME 

61 KEYBOARD CONTROL 

42 COUNTER 2 

43 TIMER CONTROL 



READ/ 
WRITE 

W 



R/W 



W 



DESCRIPTION 



Contains speaker enable and 
manual pulse train bits. See 
Keyboard documentation. 
Counter for audio speaker tone 
generation. See Timer 
documientation. 
Control register for Interval 
Timer. See Interval Timer 
documentation. 



Functions • AUTOMATIC PULSE TRAIN 

This function automatically generates an audi- 
ble sound. 
OUTPUT: 

INTERVAL TIMER CONTROL REGISTER 

BITS 1-3 = 3, square wave rate 
generator 

BITS 4-5 = 3, set counter 

BITS 6-7 = 2, generator 
INTERVAL TIME COUNTER 2 
KEYBOARD CONTROL 

BIT 0= 1, turns on speaker 

• MANUAL PULSE TRAIN 

This function manually generates an audible 
sound. 

OUTPUT: KEYBOARD CONTROL 

BIT 1 This bit is set and cleared to 
generate a pulse train. 
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Sequencing Input to the timer is 1. 2288MHz. To generate a 
and Timing 1.00 KHz tone with the audio speaker, a square 

wave rate generator is used with a count of 614 

(1.2288MHz/2*614 = IKHz). 



Sample ; 
Program BEEP 

: This program sounds the beep manually 

KEY.CONTROL EQU 61 

TIMER-CONTROL EQU 43 
BEEP: 

MOV DX, TIMER_CONTROL ;port address 
M0VAL,B8H ;of timer 

OUT DX, AL ;set channel 2 

;in mode 4 

MOV DX, KEY.CONTROL 
IN AL,DX 
MOV AH,AL 

OR AH, 01 H ;tum on Gate 

MOV BL, 80H 
BEEPl: 

MOV AL, AH ;restore value 

AND AL, OFDH 

OUT DX, AL 

MOV CX, 48H 

LOOP$ 

MOV AL, AH 

OR AL, 02H 

OUT DX, AL 

MOVE CX, 48H 

LOOP$ 

DEC BL 

JNZ BEEPl 

MOV AL,AH 

OUT DX,AL 

RET 
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Functional The AT&T Personal Computer 6300 Display 
Description Controller interfaces the CPU to either mono- 
chrome or color displays. It uses a HD6845 CRT 
Controller. The Display Controller operates in 
two basic modes — text or all points addressable 
(APR) graphics. Several resolutions are avail- 
able depending on the mode and display. 



RESOLUTION PC GRAPHIC/ COLOR/ 

COMPATIBLE TEXT MONOCHROME 

80X25 YES T C/M 

40X25 YES T C/M 

640X400 NO G M 

640X200 YES G M 

320X200 YES G C 



In text mode, character attributes include 
reverse video, blinking, highlight, hide and 
underline. In color mode if blinking is not 
requested, one of 16 colors can be chosen. Other- 
wise, one of 8 colors can be chosen. 

In graphic mode, each pixel on a color monitor is 
one of four selected colors. These four colors are 
from a choice of 16. In a monochrome monitor, 
these 16 colors are shades of gray ficom black to 
white. 

The Display Controller has 32K of RAM to 
refresh one screen page. 
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The Display Controller can be upgraded with an 
optional board. This board gives you the follow- 
ing features: 

• Up to three additional screen pages in RAM 

• Software controlled look-up table for an interna- 
tional character set 

• High resolution characters (16 X 16 pixels 
instead of 8 X 16 pixels) 

• Hardware smooth scroll 

• The ability to mix text and graphic modes 
simultaneously 

• Up to 16 colors can be displayed at once 



Block 
Diagram 




9-151 



Video Controller 



Registers 



PORT# 



NAME 



READ/ 
WRITE 



DESCRIPTION 



3D8 MODE SELECT REGISTER 1 W 

3D9 COLOR SELECT REGISTER W 

3DA STATUS REGISTER R 

3DE MODE SELECT REGISTER 2 W 

3D4 POINTER TO HD6845 REGISTER W 

3D5 HD6845 DATA REGISTER R/W 



See layout 
See layout 
Seejayout 
See layout 



HD6845 Registers 

NO NAME READ/ INITIALIZATION VALUE 

WRITE 40X25 80X25 GRAPHIC 






HORIZONTAL TOTAL 


W 


38 


71 


38 


1 


HORIZONTAL DISPLAYED 


W 


28 


50 


28 


2 


HORIZONTAL SYNC POSITION 


W 


2D 


5A 


2D 


3 


HORIZONTAL SYNC WIDTH 


W 


06 


OC 


06 


4 


VERTICAL TOTAL 


W 


IF 


IF 


7F 


5 


VERTICAL TOTAL ADJUST 


W 


06 


06 


06 


6 


VERTICAL DISPLAYED 


W 


19 


19 


64 


7 


VERTICAL SYNC POSITION 


W 


IC 


IC 


70 


8 


INTERLACE MODE 


W 


02 


02 


02 


9 


MAX. SCAN LINE ADDRESS 


W 


07 


07 


01 


A 


CURSOR START LINE (SIZE) 


W 


06 


06 


06 


B 


CURSOR END LINE 


W 


07 


07 


07 


C 


ACTIVE PAGE START ADDR (H) 


w 


00 


00 


00 


D 


ACTIVE PAGE START ADDR (L) 


w 


00 


00 


00 


E 


CURSOR ADDRESS (H) 


R/W 








F 


CURSOR ADDRESS (L) 


R/W 








10 LIGHT PEN (H) 


R 








11 LIGHT PEN (L) 


R 
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COLOR SELECT REGISTER 1 (Graphics Mode Only) 
O 1 



N/A 



Selebt Foreground Palette 
(320x200) 

Cyan, Magenta, White 



Set Foreground Intensity Off 
(320 X 200) 



Modifie d Colors (P it 3} 



640 X 200 3~20 x 200 Background 
640 X 400 000 Dark Gray 
ForegroundOOl Light Blue 

010 Light Green 

011 Light Cyan 

100 Light Red 

101 Light Magenta 

110 Yellow 

111 White 




N/A 



N'A 



Select Foreground Palette 
(320 X 700) 
Green. Red, Yellow 



Set Foreground Intensity On 
(320 X 200) 



Modify Color Selected By Bits 0-2 



_ Select Color Shade 

320 X 200 Background640 x 200 



000. Black 
001 Blue 
101 Green 
010 Cyan 

100 Red 

101 Magenta 

110 Brown 

111 Light Gray 



|640 X 400 
IForeground 



1001 Darkest 
' Gray 



STATUS REGISTER 





Display option board present 




11 No expansion 



01 12" Color monitor 

11 12' Monochrome monitor 



First half of vertical retrace 



Light Pen switched off 



Light Pen tnggered 



Horizontal Retracing 
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Text Mode Every character position is defined by two bytes: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 2 


1 





I 


R 


G 


B 


I 


R 


G 


B 


ASCII CHAR CODE 



Background Foregrounc 



Attribute Byte 



If neither the underline or blinking capabiHties 
are specified, the color choice for foreground and 
background with a color monitor is: 



Black 
Blue 
Green 
Cyan 

Dark Gray 
Light Blue 
Light Green 
Light Cyan 



Red 

Magenta 
Brown 
Light Gray 
Light Red 
Light Magenta 
Yellow 
White 



With a monochrome monitor, the color choice is: 



Black 

Darkest Gray 
Lightest Gray 
White 



The codes for common monochrome choices 
follow: 



normal 00001111 

reverse video 1 1 1 1 0000 

non-display black 00000000 

non-display white 11111111 
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When the bHnking capability is specified in 
Mode Select 1, then Bit 15 of the attribute byte 
specifies whether the character blinks. 

If the underline capability is specified in the 
Mode Select Register 2, then Bit 11 specifies 
whether the character is underlined. 

The first position in the left-hand corner of the 
screen is defined in the first two bytes of 
memory starting at BOOOO. The next position, 
one column to the right, is defined in the next 
two bytes of memory at B0002. The first charac- 
ter in the next row follows immediately after the 
definition for the last character in the first row. 
For 80 column X 25 rows, memory Jooks like 
this: 



The 80 column display uses 4K of RAM and the 
40 column display uses 2K of RAM. The rest of 
the 32K is used for multiple screen images called 
pages. There are either 16 or eight pages 
available. 



BOOOO 

BOOAO 

B0140 



Row 1 
Row 2 
Row 3 



B0E60 
BOFOO 



Row 24 
Row 25 
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Graphics In graphics mode, the display screen is a grid of 
Mode pixels, the smallest displayable unit on a video 

monitor. In medium resolution, there are 640 
across and either 200 or 400 down. 

In high resolution, each pixel is defined by one 
bit. Bit 7 of each byte defines the first pixel and 
bit defines the last pixel to be displayed. The 
background color is always black and is dis- 
played when the pixel is off. When the pixel is 
on, the foreground color is one of 16 shades of 
gray as defined in the Color Select Register Bits 
0-2 and 3. 



In medium resolution, each pixel is defined by 
two bits: 



76 


54 


32 


10 




1st 


2nd 


3rd 


4th 


PIXELS 



The value of two bits define one of four prese- 
lected colors. 



— background color 

1 — color 1 

2 — color 2 

3 — color 3 

The background color is defined by Bits 0-3 in 
the Color Select Register. Colors 1, 2, and 3 are 
cyan, magenta and white if Bit 5 of the Color 
Select Register is zero and are green, red, and 
yellow if Bit 5 is one. 

Unlike the text mode, rows of pixels do not fol- 
low one after another in memory. The following 
memory maps illustrate the layouts. 
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MEMORY MAP (640 X 400 GRAPHICS MODE) 
B8000 



B9F3F 



BAGOO 



BBF3F 



BCGOO 



BDF3F 



BEGOO 



BFF3F 



NOT USED 



NOT USED 



NOT USED 



LINES 0,4,8,...396 
8000 BYTES 



LINES 1,5,9,....397 
8000 BYTES 



LINES 2,6,10,....398 
8000 BYTES 



LINES 3,7,11,....399 
8000 BYTES 
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MEMORY MAP (320 X 200 GRAPHICS MODE) 
B8000 



B9F3F 



BAOOO 



BBF3F 



BCOOO 



BDF3F 



BEOOO 



BFF3F 



NOT USED 



NOT USED 



NOT USED 



EVEN LINES 0,2,4, 198 

8000 BYTES 
PAGEO 



ODD LINES 1,3,5, 199 

8000 BYTES 
PAGEO 



EVEN LINES 
8000 BYTES 
PAGEl 



ODD LINES 
8000 BYTES 
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Functions • INITIALIZE HD6845 

This function initializes the 16 registers of the 
HD6845 with predetermined values. 
OUTPUT: POINTER TO HD6845 REGISTER 
Number of HD6845 register 
HD6845 DATA REGISTER 
Value of HD6845 register 
(Repeat 16 times for each register) 

• SET MODE 

Set different mode characteristics such as text or 
graphics, type of graphics, blinking character, 
etc. 

OUTPUT: MODE SELECT 1 
MODE SELECT 2 



• SET COLOR TYPE 

Choose the different color or shades of gray to 
display. 

OUTPUT: COLOR SELECT REGISTER 



• SET CURSOR SIZE 

Set starting and ending line for cursor. 
OUTPUT: POINTER TO HD6845 REGISTER 
OAH 

HD6845 DATA REGISTER 

start line 
POINTER TO HD6845 REGISTER 

OBH 

HD6845 DATA REGISTER 
end line 
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• SET CURSOR POSITION 

Set cursor to location in memory. 
OUTPUT: POINTER TO HD6845 REGISTER 
OEH 

HD6845 DATA REGISTER 
most significant byte of address 

POINTER TO H36845 REGISTER 
OFH 

HD6845 DATA REGISTER 
least significant byte of address 

• READ CURSOR POSITION 

Read the current position of the cursor. 
INPUT: POINTER TO HD6845 REGISTER 
OEH 

HD6845 DATA REGISTER 
most significant byte of address 

POINTER TO H36845 REGISTER 
OFH 

HD6845 DATA REGISTER 
least significant byte of address 

• SET ACTIVE PAGE 

Set the address of the current page to display. 
OUTPUT: POINTER TO HD6845 REGISTER 
OCH 

HD6845 DATA REGISTER 
most significant byte of address 

POINTER TO H36845 REGISTER 
ODH 

HD6845 DATA REGISTER 
least significant byte of address 



Sequencing There are two methods of communicating with 
and Timing the video display. One is with I/O commands. 

This method is used to set the modes of opera- 
tion, the cursor position, the cursor size or the 
current active page. 
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Scrambler ROM 



For programs which do not use the regular 
BIOS calls, the 6845 CRT controller requires 
some additional circuitry to translate the data 
sent to it by application programs into the 
appropriate data for the display controller. 
This circuitry (called the scrambler circuitry) 
converts the IBM6845 register values to the 
values which the display controller requires. 
A listing of these conversions follows. For 
additional information see the AT&T Per- 
sonal Computer 6300 reference manual. 



SCRflM? (USED ON REV. Pl-P2fl;) 
Un recogn i zed camrnand 
»DIS ..350 



0000 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


9999999999999999 


0010 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


9999999999999999 


0020 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


9999999999999999 


0030 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


9999999999999999 


0040 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


39 


9999999999999999 


0050 


39 


39 


39 


39 


39 


39 


73 




73 


73 




73 


73 




73 




999999SSSSSSSSSS 


0060 


73 


73 




73 




73 


73 




73 


73 


70 






73 








0070 


73 


73 


73 


73 




73 


73 


73 


73 


73 


73 


73 




73 


73 






0080 


00 


01 


02 


03 


04 


05 


06 


07 


08 


09 


0fl 


0B 


0C 


0D 


0E 


0F 




0090 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


Ifi 


IB 


IC 


ID 


IE 


IF 




00ft 


20 


21 




23 


24 




26 




28 


29 


2fl 


2B 


2C 


2D 


2E 


2F 


! "#$^&' ( 1 » + ,-.'' 


0080 


30 


31 


32 


33 


34 


35 


36 


37 


38 


39 


3fl 


3B 


31:: 


3D 


3E 


3F 


0123456789: ;<=>? 


00C0 


40 


41 


42 


43 


44 


45 


46 


47 


48 


49 


4fl 


4B 


41:: 


4D 


4E 


4F 


@ft8CDEFGHIJI<LMN0 


00D0 


50 


51 


52 


53 


54 


ss 


56 




58 


59 


5fl 


58 


5C: 


5D 


5E 


5F 


PQRSTLIVHXYZ[\]A_ 


00E0 


60 


61 


62 


63 


64 


65 


66 


67 


68 


69 


6ft 


68 


6C: 


6D 


6E 


GF 


' abcde f gh i j l< 1 mno 


00F0 


70 


71 


72 


73 


74 


75 


76 


77 


78 


79 


7ft 


7B 


7C 


7D 


7E 


7F 


pqt-stuvwxyz{ 1 }~. 


0100 


00 


01 


02 


03 


04 


05 


06 


07 


08 


09 


0ft 


0B 


0C 


0D 


0E 


0F 




0110 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


Ifl 


IB 


IC 


ID 


IE 


IF 




0120 


20 


21 


22 


23 


24 




26 


■^7 


28 


29 


2fl 


2B 


2C 


2D 


2E 


2F 


!"#$^&' ( )* + ,-.'' 


0130 


30 


31 


32 


33 


34 


35 


36 


37 


38 


39 


3fl 


38 


3C 


3D 


3E 


3F 


0123456789: ;<=>'? 
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40 


41 


42 


43 


44 


45 


46 


47 


48 


49 


4fl 


4B 


4C 


40 


4E 


4F 


@flBCDEFGHIJI<Lt1N0 


0150 


50 


51 




53 


54 




56 




58 


59 


5ft 


5B 


5C 


50 


5E 


5F 


PQRSTUVWXYZ[\]A_ 


0160 


60 


61 


62 


63 


64 


65 


66 


67 


68 


69 


6fl 


6B 


6C 


6D 


GE 


GF 


' abcde f gh 1 j l< 1 mrio 


0170 


70 


71 




73 


74 


75 


76 


77 


78 


79 


7fl 


7B 


7C 


7D 


7E 


7F 


pqrstuvuxyz{|}~. 


0130 


00 


01 


02 


03 


04 


05 


06 


07 


03 


09 


0fl 


0B 


0C 


0D 


0E 


0F 




0190 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


Ifl 


IB 


IC 


ID 


IE 


IF 




0100 


20 


21 






24 




26 




28 


29 
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2B 


2C 


2D 


2E 


2F 


!"#$^&' ( )»+,-.'- 
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30 


31 
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34 


35 


36 
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38 


39 
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3D 


3E 


3F 


0123456789: ;<=>? 


01i::0 


40 


41 


42 


43 


44 


45 


46 


47 


48 


49 
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4B 


4C 


4D 


4E 


4F 


(ffiftBCDEFGHIJKLMNO 


01D0 


50 


51 


52 


53 


54 


55 


56 


57 


58 


59 


5ft 


SB 


5C 


5D 


SE 


5F 


PQRSTLIVWXY2[\]A_ 


01E0 


60 


61 


62 


63 


64 


65 


66 


67 


68 


69 


6fl 


6B 


6C 


GD 


GE 


GF 


'abcde f ghl j l< 1 mno 


01F0 


70 


07 




73 


74 




76 


77 


78 


79 


7fl 


7B 


7C 


7D 


7E 


7F 


p.rstuvwxyz{|}~. 
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CE 
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Video Controller 
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fit end of current range 



5CRRI1BB (USED ON REV. P3 AND LftTER) 
Unrecognized command 
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20 
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23 


24 
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2E 
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Gl 


62 


63 


64 
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70 


71 


72 


73 


74 
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76 


77 


78 


79 
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7C 


7D 


7E 


7F 
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01B0 


80 


81 


82 


83 






86 


87 


88 


89 


Bfl 


88 


8C 


8D 
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8F 




0190 


90 


91 


92 


93 


94 


95 


96 


97 


98 
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9B 


9C 


9D 


9E 
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0100 
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ftl 
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ft4 
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Video Controller 
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C0 
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C8 


C9 
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D0 
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0E 
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0E 
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0E 


0E 
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0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0390 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


03fl0 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


03B0 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


03C0 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


03D0 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


' 0E 


0E 


03E0 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


03F0 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0E 


0400 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


1ft 


1ft 


1ft 


0410 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


1ft 


1ft 


0420 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


1ft 


1ft 


0430 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 


Ifl 
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Ifl 


0440 


Ifl 


68 


68 


68 


68 


68 


68 


68 


68 


68 


0450 


68 


68 


68 


68 


68 


68 


68 


68 


68 


68 
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68 
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08 


09 
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37 


38 


39 


04C0 


40 


41 


42 


43 


44 


45 


46 


47 


48 


49 


04D0 


50 


51 


52 


53 


54 


55 


56 


57 


58 


59 


04E0 


G0 


61 


62 


63 


64 


65 


66 


67 


68 


69 


04F0 


70 


71 


72 


73 


74 


75 


76 


77 


78 


79 
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0E 


0E 




0E 
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0E 


0E 




0E 


0E 


0E 


0E 


0E 
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Video Controller 
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Index 



A 

A (assemble) DEBUG 
command 3-9 to 3-12 
Absolute disk read (INT 25H) 
7-19 to 7-21 

Absolute disk write (INT 26H) 
7-22 to 7-24 

Addressing 4-1 to 4-14 

Aligned words 4-5 

Allocate memory (Function 

48H) 7-140 to 7-141 

ASCII 3-15, 8-22 to 8-27 

ASCIIZ strings 5-11 to 5-12 

Assembler 1-4 

modules 2-7 to 2-8, 2-12 
in DEBUG 3-9 to 3-12 
DEBUG list 3-39 to 3-40 
using system calls 7-6 

Attribute (see File attribute 

and Video control) 

ARF (see Automatic response 

file) 

Asynchronous communica- 
tions (see communications) 
Automatic response file 2-9, 
2-19 to 2-20 

Auxiliary input (Function 03H) 
7-31 

Auxiliary output (Function 
04H) 7-32 

B 

BASIC 1-4, 7-6 
BIOS 

Memory usage 5-4, 5-5 
Service routines 8-1 to 8-36 
Block devices 9-8 



Bootstrap loader (INT 19H) 8-4, 
8-30 

Break ON/OFF Command 8-33 
Breakpoints 3-21 to 3-23 
Buffered keyboard input 
(Function OAH) 7-40 to 7-41 
Buffers Command 8-34 
Bus lines 9-6 to 9-7 

c 

C (compare) DEBUG command 
3-13 to 3-14 
Calendar (see Clock) 
Calculated addressing 4-14 
Change file attributes (Function 
43H) 7-130 to 7-131 
Change current directory 
(Function 3BH) 7-117 
Character devices 9-8 
Control-C check (Function 
33H) 7-106 to 7-107 
Check keyboard status 
(Function OBH) 7-42 
Class 2-7 
CLOCK 

device 9-26, 9-123 to 9-127 

(also see Time and Date) 
Close file 

(Function lOH) 7-50 to 7-51 

(Function 3EH) 7-122 
Clusters 5-13 to 5-23, 7-109 
COM files 3-5, 3-26, 3-30, 6-1 to 
6-7, 6-10, 6-21 
Command line 

MS-LINK 2-9, 2-18 to 2-19 

DEBUG 3-3, 3-7 to 3-8 

direct commands 6-18 
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COMMUNICATIONS 

BIOS routines (INT 14H) 8-4, 

8- 19 to 8-21 

device drivers 9-27 to 9-35, 

9- 128 to 9-146 
Compilers 1-4 
COMSPEC 6-18 

CON device (see Console) 
CONFIG.SYS 

Break ON/OFF 8-33 

Buffer 8-34 

Device 8-34 

Files 8-35 

Shell 8-35 
Console 2-12 

Direct I/O 7-35 to 7-36 

Direct input 7-37 

(also see Keyboard and 

Video) 
Control blocks (see File 
control block) 
Control-C check (Function 
33H) 7-106 to 7-107 
Country-dependent informa- 
tion 7-110 to 7-114 
Create file 

(Function 16H) 7-64 to 7-65 

(Function 3CH) 7-118 to 7-119 
Create sub-directory (Function 
39H) 7-115 

Current disk (Function 19H) 
7-68 

D 

D (display) DEBUG command 
3-15 to 3-16 



Date 

read 7-93 to 7-94, 7-157 to 
7-158 

set 7-95 to 7-96, 7-157 to 
7-158 
DEBUG 3-1 to 3-44 
Commands: 
A (assemble) 3-9 to 3-12 
C (compare) 3-13 to 3-14 
D (display) 3-15 to 3-16 
E (enter) 3-17 to 3-19 
F (fill) 3-20 
G (go) 3-21 to 3-23 
H (hexarithmetic) 3-24 
I (input) 3-25 
L (load) 3-26 
M (move) 3-28 
N (name) 3-5, 3-29 to 3-31 
O (output) 3-32 
Q (quit) 3-33 
R (register) 3-34 to 3-36 
S (search) 3-37 
T (trace) 3-38 

U (unassemble) 3-39 to 3-40 

W (write) 3-41 to 3-43 
Delete directory entry (Function 
41H) 7-127 

Delete file (Function 13H) 
7-56 to 7-58 

Determine memory size (INT 

12H) 8-4, 8-31 

DEVICES 

character 9-8 

drivers 1-4, 9-4 to 9-161 

installation 9-12 

read 7-123 to 7-124 
Device header 9-9 to 9-12 
Direct addressing 4-13 
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Direct console I/O (Function 
06H) 7-35 to 7-36 
Direct console input (Function 
07H) 7-37 

Directory 5-14 to 5-17, 5-23 

Change 7-117 

Create sub-directory 7-115 

Delete entry 7-127 

Delete file 7-56 to 7-58 

Move entry 7-115 to 7-156 

Remove directory 7-116 

Return current 7-139 

Step through 7-153 
Diskette 

allocation 5-13 to 5-23 

BIOS routines (INT 13H) 8-4, 

8-17 to 8-18 
Disk operations: 

(also see Files) 

Create sub-directory 7-115 

Current disk 7-68 

Select 7-46 

Current directory 7-139 
Delete directory entry 7-127 
Duplicate file handle 7-137 
Move directory entry 7-155 to 
7-156 

Read absolute 7-19 to 7-21 
Remove directory 7-116 
Reset 7-45 
Space 7-109 

Step through directory 7-153 
Transfer address 7-69 to 7-70, 
7-103 

Verify flag 7-101 to 7-102, 
7-154 

Write absolute 7-22 to 7-24 



Display character (Function 
02H) 7-30 

Display string (Function 09H) 

7- 39 

DMA controller 9-36 to 9-44 
DOS version number 7-104 
DSALLOCATE link switch 

2- 14 

Duplicate file handle (Function 
45H) 7-137 

E 

E (enter) DEBUG command 

3- 17 to 3-19 

Equipment check (INT IIH) 

8- 4, 8-31 
Error messages 

MS-LINK 2-24 to 2-27 

DEBUG 3-22, 3-44 

EXE2BIN 6-8 to 6-9 
EXE files (see Run files) 
EXE2BIN 6-2, 6-5 to 6-9 
EXEC (see Load and execute 
program) 

Exit address (INT 23H) 7-15 

F 

F (fill) DEBUG command 3-20 

FAT (see File Allocation Table) 

Fatal error abort address (INT 

24H) 7-16 to 7-18 

FCB (see File control block) 

FILES 

(also see Disk operations) 

allocation table 5-13, 5-18 to 

5-21, 5-22, 5-23 

attribute 5-15, 7-53 



1-3 



System 

Programer's 

Guide 



change 7-130 to 7-131 
close file 7-50 to 7-51, 7-122 
control block 3-30, 5-6 to 5-12, 

6- 16 to 6-19 

create file 7-64 to 7-65, 7-118 
to 7-119 

delete file 7-56 to 7-58 

disk transfer address 7-69 to 

7- 70, 7-103 

duplicate file handle 7-137 
forced 7-138 

find 7-151 to 7-152, 7-52 to 

7-53, 7-54 to 7-55 

header (Run files) 6-10 to 6-14 

load and execute program 

file 7-145 to 7-148 

names 7-89 to 7-92, 7-66 to 

7-67 

open file 7-47 to 7-49, 7-120 to 
7-121 

pointer 7-128 to 7-129 

random operations 
block read 7-83 to 7-85 
block write 7-86 to 7-88 
record read 7-71 to 7-72 
record write 7-73 to 7-75 
set relative record 7-79 to 
7-81 

read 7-123 to 7-124 
sequential operations 

read 7-59 to 7-61 

write 7-62 to 7-63 
size 7-76 to 7-78 
usage 2-3 to 2-6 
write 7-125 to 7-126 
Files Command 8-35 



Find file (Function 4EH) 
7-151 to 7-152 
Flags 4-8 to 4-9 
Floppy diskette interface 
controller 9-45 to 9-65 
Flush buffer, read keyboard 
(Function OCH) 7-43 to 7-44 
Force duplicate of handle 
(Function 46H) 7-138 
Free allocated memory 
(Function 49H) 7-142 
Function request (INT 21H) 
7-13, 7-29 to 7-173 
Functions (DOS) 7-2 to 7-3, 7-8 
to 7-9, 7-13, 7-29 to 7-173, 7-160 
to 7-173 

FORTRAN 2-14, 7-6 

G 

G (go) DEBUG command 3-21 
to 3-23 
Get date 

(Function 2AH) 7-93 to 7-94 

(Function 57H) 7-157 to 7-158 
Get disk free space 

(Function 36H) 7-109 
Get disk transfer address 

(Function 2FH) 7-103 
Get DOS version number 

(Function 30H) 7-104 
Get interrupt vector 

(Function 35H) 7-108 
Get time 

(Function 2CH) 7-97 to 7-98 

(Function 57H) 7-157 to 7-158 
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Global symbols (see Public 

symbols) 

Group 2-8, 2-14 

H 

H (hexarithmetic) DEBUG 
command 3-24 
Handles 5-12 

Hard disk controller 9-66 to 
9-93 

HEX files 3-4, 3-27 
HIGH Link switch 2-14 

I 

I (input) DEBUG command 
3-25 

I/O control for devices 
(Function 44H) 7-132 to 7-136 
I/O ports 9-3 

Immediate addressing 4-12 
Indirect addressing 4-13 
INPUT 

(also see files) 
auxiliary device 7-31 
control devices 7-132 to 7-136 
file or device 7-123 to 7-124 
keyboard 
buffered 7-40 to 7-41 
direct 7-38 
echo 7-29 

flush buffer 7-43 to 7-44 
Installing a device driver 9-12 
Interrupts 

In general 5-3, 5-4, 7-4, 7-7, 
7-10 to 7-28, 7-159, 8-1 to 8-32, 
9-4 to 9-5 



Get vector 7-108 

Set vector 7-82 
Interrupt controller 9-105 
to 9-115 

Interval timer 9-116 to 9-122 

K 

Keep process (Function 31 H) 
7-105 

KEYBOARD 

(also see Console) 

BIOS routines 8-4, 8-22 to 

8-28 

Buffered input 7-40 to 7-41 
Control-C check 7-106 to 
7-107 

Device driver 9-94 to 9-99 
Flush buffer read 7-43 to 7-44 
Status check 7-42 

L 

L (load) DEBUG command 3-5 
LIB files (see Libraries) 
Libraries 2-4, 2-10, 2-12, 2-17, 
2-18, 2-19, 2-22 

LINENUMBERS link switch 
2-15,2-21 

Linking object modules (see 
MS-LINK) 

List files (see MAP files) 
Load module (see Run files) 
Loading programs 6-18 to 6-22, 
7-145 to 7-148 

Load and execute program 
(Function 4BH) 7-145 to 7-148 
Logic lines (see Bus lines) 
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M 

M (move) DEBUG command 
3-28 

Macro assembler (see 
Assembler) 

MAP files 2-4, 2-10, 2-11, 2-15, 

2-16, 2-18, 2-19, 2-23 

MAP link switch 2-15, 2-21, 

2- 23 

Media check 2-19, 9-19 
Memory 

addressing 4-1 to 4-14 

allocation 7-142 to 7-144 

maps 5-1 to 5-5 

size 8-4, 8-31 
Messages (also see Error 
messages) 1-3, 3-5, 3-6, 3-35 
Modifications to BIOS 8-32 to 
8-36 

Modify allocated memory 
blocks (Function 4AH) 7-143 to 
7-144 

Move directory entry (Function 
56H) 7-155 to 7-156 
Move file pointer (Function 
42H) 7-128 to 7-129 
MS-LINK 1-4, 2-1 to 2-27 

N 

N (name) DEBUG command 

3- 5, 3-29 to 3-31 
NO link switch 2-17 
Non-aligned words 4-5 
Notation 1-3 



o 

O (output) DEBUG command 
3-32 

OBJ files (see Object modules) 

Object modules 2-2, 2-4, 2-10, 

2-11, 2-18, 2-19, 2-20 

Open file 

(Function OFH) 7-47 to 7-49 
(Function 3DH) 7-120 to 7-121 

OUTPUT 
Auxiliary device 7-32 
Character 7-30, 7-33 to 7-34 
Control devices 7-132 to 7-136 
File or device 7-125 to 7-126 
Printer BIOS routines 8-4, 
8-29 

Screen dump 8-4, 8-30 
String 7-39 

P 

Parallel printer interface 
9-100 to 9-104 

Parse file name (Function 29H) 

7-89 to 7-92 

Pascal 2-14, 2-17, 7-6 

PATH command 6-18 

Pathname string (see ASCIIZ 

strings) 

PAUSE link switch 2-15 to 
2-16, 2-20 

Print character (Function 05H) 

7- 33 to 7-34 

Print screen (INT 05H) 

8- 4, 8-30 

Printer routines (INT 17H) 
8-4, 8-29 
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Printer 2-12, 2-21, 8-4 
(also see Output) 
PRN device (see Printer) 
Process control (also see 
Memory allocation) 

Keep process 7-105 

Load and execute program 

7-145 to 7-148 

Return code 7-150 

Terminate 7-11 to 7-12, 

7-25 to 7-28, 7-149 
Program files (also see Run 
files and COM files) 

Load and execute 7-145 to 

7-148 

Structure 6-1 to 6-22 
Program segment prefix 3-5, 

6- 15 to 6-17, 6-19, 6-21, 7-11 
Program terminate (INT 20H) 

7- 11 to 7-12 

PROMPT command 6-18 
Prompts 1-3, 2-10, 2-12, 3-4, 3-12 
Public symbols 2-15, 2-20, 2-23 

Q 

Q (quit) DEBUG command 
3-33 

R 

R (register) DEBUG command 
3-34 to 3-36 

Random block read (Function 

27H) 7-83 to 7-85 

Random block write (Function 

28H) 7-86 to 7-88 

Random Read (Function 21H) 

7-71 to 7-72 



Random Write (Function 22H) 
7-73 to 7-75 

Read fi:om file or device 
(Function 3FH) 7-123 to 7-124 
Read keyboard (Function 08H) 
7-38 

Read keyboard and echo 
(Function OIH) 7-29 
Registers 4-6 to 4-10, 7-9 
Register addressing 4-12 
Remove directory (Function 
3AH) 7-116 

Rename file (Function 17H) 
7-66 to 7-67 

Request header 9-13 to 9-15, 
9-18 to 9-28 

Reset disks (Function ODH) 
7-45 

Reset verify flag (Function 
2EH) 7-101 to 7-102 
Retrieve return code of child 
(Function 4DH) 7-150 
Return country-dependent info. 
(Function 38H) 7-110 to 7-114 
Return current verify flag 
(Function 54H) 7-154 
Return current directory 
(Function 47H) 7-139 
Run files 2-4, 2-11, 2-14, 2-15, 

2- 18, 2-19, 2-21, 3-4, 3-5, 3-27, 6-1 
to 6-3, 6-5 to 6-7, 6-13 to 6-14, 
6-20 

s 

S (search) DEBUG command 

3- 37 

Scrambler ROM 9-162 
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Search for first entry (Function 

IIH) 7-52 to 7-53 

Search for next entry (Function 

12H) 7-54 to 7-55 

Sector 5-21, 5-22, 5-23, 7-109, 

8-17 

Segment 2-7, 2-14, 2-21, 3-7, 3-8, 

3- 10, 3-21, 3-28, 3-37, 4-3 to 4-4, 

4- 7, 4-11, 6-6, 6-7, 6-16, 6-18, 6-21 
Select disk (Function OEH) 7-46 
Sequential read (Function 
14H) 7-59 to 7-61 
Sequential write (Function 
15H) 7-62 to 7-63 

SET command 6-18 

Set date 

(Function 2BH) 7-95 to 7-96 
(Function 57H) 7-157 to 7-158 

Set time 

(Function 2DH) 7-99 to 7-100 
(Function 57H) 7-157 to 7-158 

Set disk transfer address 

(Function lAH) 7-69 to 7-70 

Set relative record (Function 

24H) 7-79 to 7-81 

Set interrupt vector (Function 

25H) 7-82 

Set verify flag (Function 2EH) 
7-101 to 7-102 
Shell command 8-35 
Speaker 9-147 to 9-149 
STACK link switch 2-16 
Status byte 5-5 
Step through directory files 
(Function 4FH) 7-153 
Switches 2-13 to 2-17, 2-19 
Syntax (general) 1-3 
System calls 7-1 to 7-173 



T 

T (trace) DEBUG command 3-38 
Terminate address (INT 22H) 
7-14 

Terminate but stay resident 
(INT 27H) 7-25 to 7-26 
Terminate process (Function 
4CH) 7-149 

Terminate program (Function 

OOH) 7-27 to 7-28 

Time 

get 7-97 to 7-98, 7-157 to 7-158 
set 7-99 to 7-100, 7-157 to 

7- 158 

Token (see Handle) 

u 

U (unassemble) DEBUG 
command 3-39 to 3-40 
Utility programs 1-4 

V 

Video control (also see Console 
and Output) 

BIOS routine (INT lOH) 8-4, 

8- 5 to 8-16 

Video controller 9-150 to 9-161 
VM.TMP file 2-5, 2-6, 2-16 

w 

W (write) DEBUG command 
3-41 to 3-43 

Write to file or device (Function 
41H) 7-125 to 7-126 
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DEB Capabilities 



Introduction 



The Display Enhancement Board (DEB) option 
adds improved color and graphics functionality to 
your AT&T PC 6300. When you use the DEB with 
the PC 6300 color monitor, you can display graph- 
ics in up to 16 color combinations simultaneously 
or treat the screen as two screens in one and over- 
lay one screen treatment on top of the other. When 
you use the DEB with the PC 6300 monochrome 
monitor, you have the same capabilities you have 
with the color monitor, except that colors are dis- 
played as "shades of green." 

The DEB is compatible with existing software, so 
all the programs you have already can be used now 
as if the DEB were not installed. Of course, these 
programs may not have access to any of the new 
capabilities. 

This supplement describes the functionality of the 
DEB device driver. Although it is not necessary to 
use the driver in order to use the DEB, the driver 
is designed to work with MS-DOS, GWBASIC, and 
other AT&T software products. If you wish to pro- 
gram the DEB hardware directly, you must con- 
sult the AT&T Technical Reference Manual. Such 
programming is considered a circumvention of the 
AT&T operating system and we advise against it. 

This supplement assumes that you are familiar 
with video programming through the Interrupt 
lOH interface and with INTEL® 8086 assembler 
programming. Information on the Interrupt lOH 
interface can be found in the System Program- 
mer's Guide, in the section on the ROM BIOS Ser- 
vice Routines. 
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Before you begin writing programs for the DEB, 
follow the procedures in the DEB Installation 
Manual for installing the DEB hardware and 
device driver software. 

The DEB is an optional hardware component for 
the AT&T PC 6300 that works in conjunction with 
the PC 6300's built-in Video Display Controller 
(VDC) to provide improved color and graphics 
functionality. 

The built-in VDC contains circuitry and memory 
that support either 4 color medium resolution 
(320 X 200 pixels) graphics, 1 color high reso- 
lution (640 X 200 pixels) graphics, or 1 color 
super resolution (640 x 400 pixels) graphics. 

The DEB contains additional circuitry and mem- 
ory that can be combined with the capabilities of 
the built-in VDC to produce up to 16 color combi- 
nations in either high or super resolution. You can 
also program the VDC and DEB separately, treat- 
ing them as two separate images that are com- 
bined on one screen to produce an overlaying 
effect. The overlay modes let you use up to 8 colors 
on the DEB screen and up to 16 colors on the VDC 
screen. 
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The DEB Driver 



You load the DEB device driver by entering a 
"DEVICE" statement in the CONFIG.SYS file 
(see Chapter 2, Programming Tips). The driver 
installs an Interrupt lOH "filter" during the load- 
ing process. 

When you are using the DEB and are running 
some programs that use the DEB and some that 
do not, the "filter" provides video support for both 
kinds of programs. For programs that do not use 
the DEB, the filter passes control to the standard 
Interrupt lOH ROM BIOS routine. 

The DEB driver installs a filter for Interrupt 9H. 
This filter resets the DEB to transparent mode 
whenever you warmstart the system through 
CTRL/ALT/DEL. The filter controls scrolling 
when you press CTRL/NUMLOCK. 
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16-Color Graphics 



This feature lets you display 16 color combinations 
in either high resolution (640 x 200) or super reso- 
lution (640 X 400). Not only can you use the stan- 
dard 16 colors, you can also combine colors to form 
new colors and cause pixels to blink from one color 
to another. 

The DEB provides 5 palettes for you to use when 
programming in color. At any point in your pro- 
gram, you select one of the palettes as the "active" 
palette. The color combinations contained in that 
palette determine what colors and effects show on 
the screen. 

Each of the first 4 palettes contains a default set of 
16 color combinations, but to suit the needs of your 
program you can change the contents of the palette 
to any one of the following: 

• any of the 16 standard colors with which you are 
already familiar from the standard applications. 
The standard colors are: 






= black 


8 


= gray 


1 


= blue 


9 


= light blue 


2 


= green 


10 


= light green 


3 


= cyan 


11 


= light cyan 


4 


= red 


12 


= light red 


5 


= magenta 


13 


= light magenta 


6 


= brown 


14 


= yellow 


7 


= white 


15 


= high intensity white 



• a mixture, or "dithering," of any 2 of the 16 stan- 
dard colors 



• an alternation, or blinking, between any 2 of the 
standard 16 colors 
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The last palette contains no default combinations. 
You program the fifth palette by loading color val- 
ues into a 256-byte array. The DEB device driver 
uses this special palette to program the DEB's 
color Look-Up Table (LUT). By using the LUT you 
can add the capability of dithering or blinking 
between any four colors. 
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Look-Up Table (LUT) 



The LUT resides in RAM on the DEB board, and is 
accessed through write-only hardware registers. 
The device driver keeps a copy of the register val- 
ues in the LUT. The regist^ values are accessible 
to software applications through the device driver. 
The LUT contains 256 values that determine the 
colors, blinking, and dithering that appear on the 
screen. Whether you need to learn about the use 
and layout of the LUT depends on the application 
you are writing. 

If you use the standard palettes, you need not be 
concerned with the LUT. The DEB device driver 
automatically programs the LUT to correspond to 
the way you set up the palettes. If you program a 
custom LUT, you greatly increase the color combi- 
nations and blinking effects available to you. 
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Overlay Modes 



The overlay modes let you use the screen to 
display two images at once, independently. For 
example, you can display a high resolution color 
graphics image with its own foreground and back- 
ground. Then, on "top" of that image, you can dis- 
play a box of text and scroll the text without 
affecting the graphics image. 

The overlay modes use the DEB to control one 
image and use the standard controller board to 
control the other image. You can select from many 
combinations of graphics, text, color, and high or 
super resolution in designing the two images. 
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The overlay modes offer 5 palettes. Each of the 
first 4 palettes has 8 positions. These four palettes 
have default colors that you can change to suit 
your needs. You can choose 8 color combinations 
from any of the 16 standard colors, or blink 
between 2 of the standard colors. The dithering 
combinations of the 16-color graphics modes are 
not available. You can also use the last palette to 
custom program the LUT. 
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• Presence of Hardware/Software 

• Hardware/Software Compatibility 

• Setup 



Programming Tips 



Presence of Hardware/Software 



Whenever you plan an application, it is important 
to use the DEB device driver to test for the pres- 
ence of both the DEB and the associated driver. 
Test for the presence of the hardware by checking 
for DEB video memory. This is accomplished by 
writing and reading back data patterns into mem- 
ory, in the range AOOOH:OH to B800H:OH. Test for 
the software device driver by issuing a function 
call to open the device called "DEBDRIVE," then 
immediately issuing a call to close "DEBDRIVE." 
If the open fails (carry set on return from Inter- 
rupt 21H) then the driver is not present. No func- 
tions are implemented in the driver, which is used 
only to detect the presence of the software. 
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Hardware/Software 
Compatibility 



The driver software has been designed to fit into 
the structure of MS-DOS programs. The DEB 
hardware uses the same range of addresses as the 
standard video ports on any compatible machine. 
If your appHcation uses a light pen, consult the 
DEB supplement in the AT&T Personal Computer 
Technical Reference Guide. 

The DEB driver makes minor modifications to the 
ROM BIOS video interrupt. Mode setting and color 
selection offer additional functionality. Be careful 
when you use the following functions. 

• SET MODE — uses an additional register BL 

• SCROLLING — uses an additional register BH 

• STATUS — returns an additional register pair 

ES:DI. No application should count on 
ES:DI not changing. 
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Setup 



Install the DEB driver just as you would install 
any device driver. Be sure the CONFIG.SYS file 
is in the root directory. Put the line DEVICE = 
DEDRIVER.DEV in CONFIG.SYS. This line puts 
the DEB driver in the device driver chain. The 
driver makes patches in INT lOfI and INT 9H to 
add the new functionality. The driver has two 
features: 

• the INIT function, which deallocates itself after 
it runs 

• chaining, which allows you to test for the driver's 
presence by issuing an open function call 
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• Overview 

• Mode Setting 

• Setting Colors and Effects 

• Displaying Graphics Images 
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How to Program 
the DEB 



Overview 



There are three steps for video programming that 
apply whether or not you are using the DEB 
capabihty: 

1 Set the hardware's mode. You also must set the 
active page if you are in an overlay mode and want 
to select the DEB screen. 

2 Select the color combinations and effects you want 
to use. 

3 Construct the graphics images you want to display. 

This chapter describes each of these steps in 
detail. This chapter does not describe how to pro- 
gram the LUT directly (see Chapter 5, "Pro- 
gramming the LUT"). 
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Mode Setting 



The DEB is controlled by invoking one of the DEB 
video modes through the Set Mode function (INT 
lOH, function OH) . The Set Mode function estab- 
lishes the mode for both the DEB and the VDC. 
These modes fall into four categories: 16-color 
graphics, overlay, transparent, and disabled. 

16-Color There are two DEB modes that provide 16-color 

Graphics graphics: high resolution and super resolution. 

Modes Both these modes let you use 5 palettes and dis- 

play up to 16 color combinations simultaneously. 

Overlay When overlaying the VDC on the DEB output, 

Modes you specify one of the modes for the VDC and one 

mode for the DEB. The VDC modes are a subset of 
the modes for non-DEB graphics: 80 x 25 text 
mode, high and super resolution modes. The DEB 
modes are both graphics modes: high and super 
resolution. 



If you are using one of the four standard palettes, 
the VDC's output takes precedence over the output 
of the DEB, so that if each board writes a pixel to 
the same screen location, the pixel sent by the 
VDC is displayed. This precedence is programmed 
into the LUT. If you want to have the DEB take 
precedence over the VDC, you must change the 
values in the LUT. (For more information, see 
Chapter 5, "Programming the LUT.") 
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Transparent The non-DEB modes, modes 0-40H and mode 48H, 
Mode work exactly as they work without the DEB device 

driver installed. 



Disabled In the disabled mode, you can cause the output of 

Mode the VDC , the DEB , or both to be blacked out. This 

allows you to draw a graphics image or to fill a 
screen with text and not have them displayed 
while you are building them. You can then have 
the image "pop up" by taking VDC or DEB out of 
the disabled mode. You can also achieve this result 
by using the programmable palettes and the LUT. 
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Setting Colors and Effects 



Colors and effects are controlled by the Set Color 
Palette command, (INT lOH function OBH). Use 
this function to set color values in one of the four 
palettes, to switch between palettes, or to reset 
palettes to their default values. You also use Set 
Color Palette to program the LUT directly. 



3-5 
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the DEB 

Displaying Graphics Images 



There are two methods for displaying graphics 
images using the DEB: writing dots at screen 
locations or directly programming the VDC and 
DEB memory. 

To write dots (pixels) to the screen, use the Write 
Dot function (INT lOH, function OCH). Write Dot 
requires that you specify the display page, the row 
and column where you want the dot to appear, and 
the color or pattern for the dot. 

If you want to program the VDC and DEB graph- 
ics memory directly , you need to learn the details 
of how the LUT is structured and how LUT 
addresses are formed (see the section on "Pro- 
gramming the Bit Planes" in Chapter 5). 
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Interrupt lOH 
Functions 

Introduction 



The following section describes the DEB device 
driver software functions. This interface is an 
extension of the INT lOH software function to the 
PC6300 ROM BIOS that controls the VDC. The 
ROM BIOS screen driver has 16 functions: 

OH set the display mode 

2H set the cursor position 

3H read the cursor position 

5H select the active display page 

6H scroll the active page up 

7H scroll the active page down 

8H read character/attribute at the current cur- 
sor position 

9H write character/attribute at cursor position 

AH write only the character at current cursor 
position 

BH change the color palette 

CH write a point on the screen 
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DH read a point on the screen 

EH write in teletype style to the active page 

FH return information about the active video 
state 

Not all these functions are applicable to the DEB. 
The filter receives the Interrupt lOH function call, 
filters the functions that are applicable to the DEB 
and performs them. The functions that are not 
applicable to the DEB are passed on to the ROM 
BIOS INT lOH routine or to a previously installed 
filter or driver routine. The following section 
describes the functions which are processed by the 
DEB Interrupt lOH filter. 
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Functions 



Set Mode The function establishes the mode for both the 

DEB and the VDC. If you select a non-DEB related 
mode, control is passed to the ROM resident Set 
Mode function. Set Mode initializes palette as 
the active palette. 

Input (AH) = OH function number for Set Mode 

(AL) = new mode 
(BL) = optional overlay mode 

Setting AL bit 7 = puts you in either the DEB 
transparent mode or 16-color graphics mode: 

(AL) = OH 40 X 25 monochrome, text 

(AL) = IH 40 X 25 color, text 

(AL) = 2H 80 X 25 monochrome, text 

(AL) = 3H 80 X 25 color, text 

(AL) = 4H 320 X 200 color 

(AL) = 5H 320 X 200 monochrome 

(AL) = 6H 640 X 200 color 

(AL) - 40H 640 x 400 with 2-position program- 
mable palette, defaulting to black 
and white 

(AL) = 41H 640 X 200 16-color graphics with 

four palettes 
(AL) = 42H 640 x 400 16-color graphics with 

four palettes 
(AL) = 44H Disable mode (disables both DEB 

and VDC output) 
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Setting AL bit 7 = 1 puts you in overlay mode. The 
following values are only used in overlay mode. AL 
contains the setting for the VDC; BL contains the 
mode setting for the DEB. In overlay modes, the 
active page defaults to zero. 



VDC Settings 



(AL) = 


82H 


80 X 25 monochrome, text 


(AL) = 


83H 


80 X 25 color, text 


(AL) = 


86H 


640 X 200 color graphics 


(AL) = 


OCOH 


640 X 400 color graphics 


(AL) = 


0C4H 


Disable mode. Disables only the 






VDC. 



DEB settings (BL) = 6H 640 x 200 graphics with four 

8-position palettes. 
(BL) = 40H 640 x 400 graphics with four 

8-position palettes. 
(BL) = 44H Disable mode. Disables only the 
DEB. 



Output 
Example 



Contents of all registers are preserved. 



MOVAH.O 
MOVAL,41H 
INT lOH 



; Select Set Mode 

; Select 16 color graphics 

; Change the mode 



4-5 



Interrupt lOH 
Functions 



Set Cursor This function sets the cursor position for either the 
Position DEB, the VDC, or both. 



Input 



(AH) = 2H Function number for Set Cursor 
Position 

(DHjDL) = row, column of new position 

(BH) = page number 

Valid page numbers for DEB modes 
are for the VDC and 80H for the 
DEB in overlay mode. Row values 
are thru 23, column values are 
thru 79, in DEB modes. 



Output Contents of all registers are preserved. 

Example MOV AH, 2 ;SCP function 

MOV DH.ROW 
MOV DL.COL 
MOV BH,PAGE 

INT 1 OH ; Moves cursor to position defined in 
above variobles. 
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Read Cursor This function returns the position of the cursor for 
Position the DEB, VDC, or both. 



3H Function number for Read Cursor 
Position 
page number 

Valid page numbers for DEB modes are 
for VDC and 80H for the DEB in over- 
lay mode. Row values are thru 23, col- 
umn values are thru 79, in DEB 
modes. 

Output (DH,DL) = row, column of current position. 

Contents of all other registers are preserved. 

Example MOVAH,3 

MOV BH.PAGE 
INT lOH 
MOV ROW.DH 
MOV COL,DL 



Input (AH) = 

(BH) = 
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Select 
Active 
Display 

Input 



Output 
Example 



This command allows selection of the DEB display 
in overlay mode. 



(AH) = 5H Function number for Select Action 
Display 

(AL) = active page 

Values for the active page in DEB modes 
are, for the VDC and 80H for the DEB. 

Contents of all registers are preserved. 

MOV AH, 5 
MOVAL.PAGE 
INT lOH 
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Scroll 
Active 
Page Up 



This function defines a pattern that is to be dis- 
played on the blank lines as the screen scrolls. The 
pattern consists of ones and zeros. Zeros are inter- 
preted as the background color (palette position 
zero). Ones are interpreted as the foreground color, 
which is defined in BL. Care should be taken when 
scrolling in DEB modes, to insure that all applica- 
tions set the additional argument in BH correctly. 



Input 



(AH) = 6H function number for Scroll 

Active Page Up 
(AL) = number of lines to scroll 
(CH,CL) = row, column of upper left corner to 

scroll 

(DH,DL) = row, column of lower right corner to 
scroll 

(BH) = pattern to be used on blank lines 

(BL) = foreground color 

The range of lines to be scrolled is 
thru 23 (where specifies clear 
screen). 

Row values are thru 23, column 
values are thru 79, in DEB modes. 
Valid foreground colors are specified 
by palette position 0-FH for 16-color 
graphics, and 0-7H for 8-color 
graphics. 



Output Contents of all registers are preserved. 

Example MOVAH,6 ;Scroll Active Page Up 

MOVAL.LINES 
MOVCH.UPROW 
MOVCL.UPCOL 
MOVDH.LOWROW 
MOVDL,LOWCOL 
MOV BH.O 
MOVBL.FGCOLOR 
INT lOH 
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Scroll This function permits you to define a pattern that 

Active is to be displayed on the blank lines as the screen 

Page Down scrolls downward. The pattern consists of ones and 
zeros. Zeros are interpreted as the background 
color (palette position zero). Ones are interpreted 
as the foreground color, which is defined in BL. 
Care should be taken when scrolling in DEB 
modes, to insure that all applications set the addi- 
tional argument in BH correctly. 



Input (AH) = 7H function number for Scroll 

Active Page Down 
(AL) = number of lines to scroll 
(CH,CL) = row, column of upper left corner to 

scroll 

(DH,DL) = row, column of lower right corner to 
scroll 

(BH) = pattern to be used on blank lines 

(BL) = foreground color 

The range of lines to be scrolled is 
thru 23 (where specifies clear 
screen). 

Row values are thru 23, column 
values are thru 79, in DEB modes. 
Valid foreground colors are specified 
by palette position 0-FH for 16-color 
graphics, and 0-7H for 8-color 
graphics. 



Output Contents of all registers are preserved. 



Example MOVAH,7 ; Scroll Active Page Down 

MOVAL.LINEiS 
MOV CH.UPROW 
MOV CL.UPCOL 
MOV DH.LOWROW 
MOV DL.LOWCOL 
MOV BH,0 
MOV BL.FGCOLOR 
INT lOH 
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Read 

Character 

and 

Attribute 
at Current 
Cursor 
Position 



This function returns the value of the character at 
the current cursor position. The value of the char- 
acter's foreground color is returned in AH, 



Input 



Output 



(AH) = 8 Function number for Read Character 
and Attribute at Current Cursor 
Position, 

(BH) = Valid page numbers for DEB modes are 
for the VDC and 80H for the DEB in 
overlay mode. 

(AL) = ASCII character code 
(AH) = foreground palette position or VDC 
attribute 



Contents of all other registers are preserved. 

Example MOVAH,8 ; Read CHR function 

MOV BH.PAGE 
INT lOH 

MOV CHAR.AL ;Save CHAR/COLOR 
MOV CURCOLOR,AH 
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Write 

Character 

and 

Attribute 
at Current 
Cursor 
Position 



This function displays the character whose ASCII 
code is in register AL. The character is displayed 
according to the color values in BL. 



Input 



(AH) = 9H Write Character function 

(AL) = ASCII character code 

(BL) = foreground color 

(BH) = page 

(CX) = count of characters to write 



Output 
Example 



If bit 7 of BL = 1, the color value is XOR'd with the 
current dots in that location. Valid page numbers 
for DEB modes are for the VDC and 80H for the 
DEB in overlay mode. 

Valid foreground colors are specified by palette 
position 0-FH for 16-color graphics, and 0-7H for 8- 
color graphics. 

Contents of all registers are preserved. 

M0VAH,9 
MOV AL, CHAR 
MOV BL,CURCOLOR 
MOV BH,PAGE 
MOV CX,1 
INT lOH 
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Write In DEB modes, this function is the same as "Write 

Character Character and Attribute." 

Only at 

Current 

Cursor 

Position 



4-13 



Interrupt lOH 
Functions 



Set Color This function is used to set color values in one of 

Palette the four palettes, to switch between palettes, or to 

reset palettes to their default values. 

In the overlay modes, the Set Color Palette func- 
tion works on the active page. If the active page 
is set to display to the VDC board, this function 
works the same as the standard ROM BIOS INT 
lOH (function OBH). 

If you specify a palette position greater than the 
value allowed for the mode in which you are work- 
ing, the value you specify will be put in that 
palette's highest position. For example, if you 
attempted to set palette position 13 to red when 
working in overlay mode, which has 8-position pal- 
ettes, the 8th palette position would be set to red. 

Note: 

The following discussion covers the use of the sim- 
ple palette programming functions. You can also 
use "Set Color Palette" to program the LUT. (For 
more information, see Chapter 5, "Program- 
ming the LUT"). 
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Input (AH) = OBH Function number for Set Color 

Palette 

(AL) = palette function selector 
(BH) = positional pointer 
(BL) = color value 

For simple palette programming functions, use the 
following 

(AL) = 

(BH) = palette color ID 

BH = FFH switches to the palette 
specified in BL, without 
changing to the default 
palettes unless there is a 
change in palette type 
(e.g., change from a 16- 
position palette to an 8- 
position palette). 

BH = 80H switches to the palette 

specified in BL and resets 
the palette to its default. 

BH = 0-16 sets this palette position to 
the color or attribute in 
BL. 

(BL) = actual color value or code for blinking 
and dithering 
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The special settings for using a customized LUT in 
Set Color Palette are as follows: 

(AL) = non-zero (a zero here selects a standard 
palette) 

AL bit = 1 means use ES:SI to program the 

palette and registers BH and BL to 
indicate an offset and length into 
the LUT. ES:SI points to the LUT 
table (in the above example, 
LUT-STRING). 

In this case, BH = offset into LUT 
andBL = length of portion of LUT 
to be changed. If you are loading 
an entire new table, set BH and BL 
toO. 

AL bit 1 = 1 means use BH and BL to program 
the LUT one location at a time. 

In this case, BH = position in LUT 
and BL = the value to put in that 
position. 



ALbit2 = 1 



means use the short LUT address- 
ing mode. (Only uses the first 16 
LUT entries). 
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The DEB driver lets you automatically load 
your customized LUT and use it in place of one of 
the standard palettes. 

The steps for loading and using the customized 
LUTare: 

1 Define the table with DB (Define Byte) 
statements. 

2 Load the table in by using the Set Color Palette 
command. 

3 Use the Read Dot and Write Dot commands to 
access the LUT (see Chapter 4, "Interrupt lOH 
Functions"). 

The code for defining the table would be similar to 
this: 



LUT-STRING 



DB 
DB 
DB 
DB 
DB 



4 ! Signifies active palette 4 



1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 
1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 
1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 
1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 



DB 



1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 
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To load a new table of values into the LUT, where 
the table in your program is named LUT-STRING, 
you can use these statements: 



PUSH DS ! save the data segment address 

POP ES 

MOV SI, LUT -STRING 
MOV AL.l 
MOV AH, 11 

XOR BH.BX !SetsBH = BL = 
INT 10 
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The defaults for each of the four palettes are: 

Default Palette Number 

Palettes Position Color 






= black 


1 


2 = green 


2 


4 = red 


3 


6 = brown 


4 


l=blue 


5 


3 = cyan 


6 


5 = magenta 


7 


7 = white 


8 


8 = gray 


9 


9 = light blue 


10 


10 = light green 


11 


11 = light cyan 


12 


12 = light red 


13 


13 = light magenta 


14 


14 = yellow 


15 


15 = high-intensity white 
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Palette Number 1 



T* * J. * 

Position 


Color 


U 


U = DlaCK 


1 


3 = cyan 


2 


5 = magenta 


3 


7 = white 


4 


1 = blue 


5 


2 = green 


6 


4 = red 


7 


6 = brown 


8 


8 = gray 


9 


9 = light blue 


10 


10 = light green 


11 


11 = light cyan 


12 


12 = light red 


13 


13 = light magenta 


14 


14 = yellow 


15 


15 = high-intensity white 
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Interrupt lOH 
Functions 



Palettes 2 and 3 are the same, and they contain the 
standard colors in numerical order. 

Palette Number 2 and Palette Number 3 

Position Color 



= black 

1 l = blue 

2 2 = green 

3 3 = cyan 

4 4 = red 

5 5 = magenta 

6 6 = brown 

7 7 = white 

8 8 = gray 

9 9 = light blue 

10 10 = light green 

11 11 = light cyan 

12 12 = light red 

13 13 = light magenta 

14 14 = yellow 

15 15 = high-intensity white 
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DITHER COMBINATIONS FOR 
DEB PALETTES 0-3 



Color combinations 136-255 have been pre-assigned to allow you easy 
access to dithering effects while using the standard palettes. The fol- 
lowing table describes the available combinations. 



Qj 0) S bo 

Cfl 3 « CS 



A ^ ^ ^ ^ B B ^ ^ ^ 

\ 

black 

blue 136 
green 137 138 

cyan 139 140 141 

red 142 143 144 145 

magenta 146 147 148 149 150 
brown 151 152 153 154 155 156 

white 157 158 159 160 161 162 163 

gray 164 165 166 167 168 169 170 171 

light blue 172 173 174 175 176 177 178 179 180 
light green 181 182 183 184 185 186 187 188 189 190 
light cyan 191 192 193 194 195 196 197 198 199 200 201 
light red 202 203 204 205 206 207 208 209 210 211 212 213 

light magenta 214 215 216 217 218 219 220 221 222 223 224 225 226 
yellow 227 228 229 230 231 232 233 234 235 236 237 238 239 240 

high-intensity 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 
white 

NOTE: To select a value that combines colors A and B to create a new color, find 
the number at the intersection of row A and column B. 
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BLINKING COLOR EFFECTS 
FOR DEB PALETTES 0-3 



Color combinations 16-135 have been pre-assigned to allow you easy 
access to blinking effects while using the standard palettes. The fol- 
lowing table describes the available combinations. 



CO 3 O « T3 cs *i 

B-l SSI IJ-f Sllllll^ 

A 

i black 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 

blue 31 32 33 34 35 36 37 38 39 40 41 42 43 44 

green 45 46 47 48 49 50 51 52 53 54 55 56 57 

cyan 58 59 60 61 62 63 64 65 66 67 68 69 

red 70 71 72 73 74 75 76 77 78 79 80 

magenta 81 82 83 84 85 86 87 88 89 90 

brown 91 92 93 94 95 96 97 98 99 

white 100 101 102 103 104 105 106 107 

gray 108 109 110 111 112 113 114 

light blue 115 116 117 118 119 120 

light green 121 122 123 124125 

light cyan 126 127 128 129 

light red 130 131132 

light magenta 133 134 

yellow 135 

NOTE: To select a value that will cause blinking between colors A and B, find 
the number at the intersection of row A and column B. 
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Write 
Dot 



Input 



The Write function writes a pixel to the location on 
the screen that you specify. If the screen is in the 
DEB mode, Write Dot may also write a pattern. 

(AH) = OCH, Function number for Write Dot 
(AL) = Palette position to be written. 
(BH) = display page designator (bit 7 = 1 

selects the DEB) 
(CX) = column number 
(DX) = row number 



Output Contents of all registers are preserved. 

Example MOVAH.OCH 

MOVAL.PALPOS 
MOV BH,PAGE 
MOV CX,COL 
MOV DX,ROW 
INT ;WritetheDot 
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Read Dot This function reads a dot from the screen. If the 

screen is in the DEB mode this function returns 
the value in the LUT that corresponds to this dot. 
(For more information, see Chapter 5, "Pro- 
gramming the LUT.") 



Input 



(AH) = ODH Function number for Read Dot 
(BH) = display page designator (bit 7=1 

selects the DEB) 
(CX) = column number 
(DX) = row number 



Output 



(AH) = VDC value or DEB palette position 
Contents of all other registers are 
preserved. 



Example 



MOVAH.ODH 

MOVBH,PAGE 

MOVCX.COL 

MOVDX,ROW 

INT 

MOVDOTCOL,AH 



;Save the Dot 
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Input 



(AH) 



OEH, Function number for Write 



Teletype 
(AL) = character to write 
(BL) = foreground color (in graphics modes) 

If bit 7 = 1, color is XOR'd to current 

contents. 



Output 



Contents of all registers are preserved. 



Example 



MOVAH.OEH 
MOVAL.CHAR 
MOVBL,FGCOL 
INT lOH 
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Read 
Current 
Video 
State 

Input 



Output 



Example 
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This function returns the current video state. It 
indicates whether the DEB or VDC is active in the 
overlay mode and returns the number of the active 
palette. 

(AH) = OFH Function number for Read Cur- 
rent Video State 

(BH) = display page designator 

(AL) = mode currently set 

(ES:DI) = pointer to a copy of the current LUT 

MOV AH, OFH 
INT lOH 
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Programming the LUT 



Overview 



This chapter describes programming the DEB 
Look-Up Table (LUT). By programming the LUT 
yourself, you can create color patterns that are not 
available when you use standard palettes. You 
need not read this chapter if you do not want to use 
this extended functionality. 

The hardware uses the LUT to translate the con- 
tents of video memory patterns into graphics 
effects. In the standard palettes, INT lOH filter 
programs the LUT for you and thereby provides the 
preassigned color combinations and effects as 
described in previous chapters. 

To program the LUT directly, you select Palette 4 
in Set Color Palette function. Palette 4, also called 
the "LUT palette," has a minimum of 256 posi- 
tions. Each palette position contains a value 
between and 15. These values map into the LUT 
locations on the DEB. The 256 locations on the 
DEB collectively determine the color and special 
effects displayed when you specify a particular 
palette position. The color and special effect for 
each pixel on the screen are determined by: 

• the palette position you specify 

• the values in the LUT 

• the active mode 

There are some differences in the way the LUT is 
structured for 16-color graphics modes and overlay 
modes. This chapter describes LUT operation for 
16-color graphics modes and overlay modes 
separately. 
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16-Color Graphics Lut 
Programming 



In these modes, the LUT can be viewed as a two- 
dimensional array (16 x 16). Each location con- 
tains one of the standard 16 colors. 

Palette Position 
Column 



15 



LUT 
Row 



15 



The locations in the LUT are numbered consecu- 
tively from left to right and top to bottom. Thus, 
location 17 corresponds to Row 1, palette position 1. 
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Programming the LUT 



In the 16-color graphics mode, the LUT is divided 
into four "time states." At any one time, only one 
quarter of the LUT determines the display on the 
screen. 



Palette Position 



15 




LUT 
Row 




11 




12 



15 




The hardware cycles through the LUT every sec- 
ond, so each quarter of the LUT is active for of 
each second. The cycling mechanism produces 
blinking. The following examples show the details 
of how you can produce several different blinking 
effects by setting different values in the LUT. 
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In this example, the Write Dot or Write Character 
functions specify palette position 7 and the LUT is 
set up as shown. Pixels are displayed as a solid red 
color. In the first V4 second, the DEB displays the 
color in the first quarter of the LUT, which in this 
case is red. In the second, third, and fourth y4 sec- 
onds, the DEB displays the color in the second, 
third, and fourth quarters of the LUT, respec- 
tively. In this example, the DEB keeps finding the 
color value for red, so what you see on the screen is 
a solid (non-blinking) red color. 



Palette Position 



LUT 
Row 



15 







t(0) 



t(l) 



t(2) 



t(3) 



11 



12 



15 




Non-Blinking Color 
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In this example, any item displayed on the screen 
with palette position 7 blinks between red and 
blue. For the first two V4 seconds, the DEB picks 
up the color value for red from the first and second 
quarters of the LUT. For the second two V4 seconds, 
the DEB obtains the color value of blue from the 
LUT. The net effect is a slow blink between red 
and blue. 

Palette Position 

LUT 

Row 7 15 



t(o) ; 

3 




t(l) 




t(2) 



11 




t(3) 



12 



15 




Slow Blink 
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Programming the LUT 



In this example, any item displayed using palette 
position 7 blinks rapidly between red, blue, green, 
and brown. 

Palette Position 



LUT 
Row 



15 



t(0) 








t(l) 




t(2) 



11 




t(3) 



12 



15 




4-Color Fast Blink 



5-7 



Programming the LUT 



For dithering colors, the DEB uses a scheme simi- 
lar to the blinking scheme. Dithering is accom- 
plished by manipulating groups of 4 adjacent 
pixels. The screen is divided into blocks of 4 pixels. 
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Programming the LUT 



Each of the 4 time states is divided into four dither 
states that determine the dithering effect. The 
rows of the time state blocks correspond to the 4- 
pixel blocks on the screen in the following way: 



LUT 
Row 


1 

2 
3 






1 


2 


3 



Time 
Block 
Row 



Palette Position 



15 





9 
10 
11 




12 
13 
14 
15 
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Programming the LUT 



The pixels in the pixel blocks are so close together 
that our eyes cannot perceive them as separate. If 
each of the pixels in a pixel block is a different 
color, our eyes perceive the pixel block as one color 
— a combination of the color of the individual pix- 
els. If the adjacent pixels are the same color, our 
eyes see just that one color. 



red 


red 


red 


red 



Palette Position 



Time 
Block 
Row 

t(0) 



t(l) 



t(2) 



t(3) 



15 




"Solid" Dither showing correspondence between pixel 
positions in a pixel block and time state rows 
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Programming the LUT 



Remember the table of "pre-assigned" dithered 
colors. To combine colors, you check the table for 
the color number for a particular dither effect. For 
example, you would choose this number to produce 
a dither between red and blue. 



RED 




BLUE 
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If you want to program the LUT directly to dither 
red and blue together, the LUT would look like 
this: 



t(0) 



blue 


red 


blue 


red 




blue 


red 


blue 


red 







Time 
Block 
Row 



Palette Position 
7 



15 




t(l) 




t(2) 




t(3) 




2-Color Dither 
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Programming the LUT 



You can set up the LUT to dither two, three, or four 
colors together. 



red 


blue 


grn 


brn 



Palette Position 



Time 
Block 
Row 



15 



t(0) 




t(l) 




t(2) 




t(3) 




4-Color Dither 
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Programming the LUT 



The following examples show the actual LUT val- 
ues for each of the previous cases of blinking and 
dithering. 

Palette Position 

LUT 

Row 7 15 



4 (red) 

1 4 
t(0) 2 4 

3 4 



t(l) 




t(2) 




t(3) 




Palette Position 7 programmed for Non-Blinking Red 
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Palette Position 



t(0) 



LUT 
Row 



15 




t(l) 




t(2) 




t(3) 




Palette Position 7 programmed to blink slowly between red 
and blue. 
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Palette Position 



t(0) 



LUT 
Row 



15 




t(l) 




t(2) 




t(3) 



12 
13 
14 
15 



6 (brown) 

6 

6 

6 



4-Color Fast Blink 
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t(0) 



LUT 
Row 



Palette Position 
7 



15 




t(l) 




t(2) 




t(3) 




Solid Red Dither 
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Programming the LUT 



t(0) 



LUT 
Row 



Palette Position 
7 



15 




t(l) 




t(2) 




t(3) 




2-Color Dither: Red and Blue 
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Programming the LUT 



Palette Position 



t(0) 



LUT 
Row 



4 (red) 

2 (green) 

1 (blue) 

6 (brown) 



15 



t(l) 




t(2) 





4-Color Dither Between Red, Green, Blue, and 
Brown 
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Programming the LUT 



The following is an example that combines blink- 
ing and dithering: 

Palette Position 



LUT 
Row 



15 



t(0) 




t(l) 




t(2) 



9 
10 
11 



2 (green) 
6 (brown) 
2 
6 



t(3) 
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The following table of values can be used to pro- 
gram the LUT for normal 16-color graphics. 

Palette Position 



LUT 








Row 


1 2 3 4 5 


6 7 I 


B 9 10 11 12 13 14 15 





0, 1,2,3,4,5, 


6,7, 


3,9,10,11,12, 13,14, 15, 


1 


0, 1,2,3,4,5, 


6,7, 


3,9, 10,11,12, 13,14, 15, 


2 


0,1,2,3,4,5, 


6,7, 


3, 9, 10,11,12, 13, 14, 15, 


3 


0, 1,2,3,4,5, 


6,7,< 


3,9, 10, 11, 12, 13, 14, 15, 



4 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 

5 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 
t(l) 6 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 

7 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 



8 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 

9 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 
t(2) 10 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 

11 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 



12 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 

13 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 
t(3) 14 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 

15 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 



Non-Blinking Standard Colors 
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Note that palette position 7 in the first two time 
states has been programmed to show white and in 
the second two time states to show red. 



Palette Position 



LUT 








Row 


12 3 4 


5 6 7 


8 9 10 11 12 13 14 15 





0,1,2,3,4, 


5,6,7, 


8, 9, 10, 11, 12, 13, 14, 15, 


1 


0,1,2,3,4, 


5,6, 7, 


8,9, 10,11,12, 13, 14, 15, 


2 


0, 1,2,3,4, 


5, 6, 7, 


8,9, 10,11,12, 13, 14, 15, 


3 


0, 1,2,3,4, 


5,6, 7, 


8,9, 10,11,12, 13, 14, 15, 



4 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 

5 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 
t(l) 6 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15, 

7 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 



8 0, 1, 2, 3, 4, 5, 6, 4, 8, 9, 10, 11, 12, 13, 14, 15, 

9 0, 1, 2, 3, 4, 5, 6, 4, 8, 9, 10, 11, 12, 13, 14, 15, 
t(2) 10 0,1,2,3,4,5,6,4,8,9,10,11,12,13,14,15, 

11 0, 1, 2, 3, 4, 5, 6, 4, 8, 9, 10, 11, 12, 13, 14, 15, 



12 0, 1, 2, 3, 4, 5, 6, 4, 8, 9, 10, 11, 12, 13, 14, 15, 

13 0, 1, 2, 3, 4, 5, 6, 4, 8, 9, 10, 11, 12, 13, 14, 15, 
t(3) 14 0,1,2,3,4,5,6,4,8,9,10,11,12,13,14,15, 

15 0, 1, 2, 3, 4, 5, 6, 4, 8, 9, 10, 11, 12, 13, 14, 15, 



LUT for Blinking Between White and Red in Palette 
Position 7 
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Overlay Modes LUT 
Programming 



Overlay When the LUT is used in the overlay modes it can 

Modes LUT be viewed as a two-dimensional array with 8 col- 
Programming umns and 32 rows. The column values are DEB 

palette positions. The row values are VDC color 

values. 



In overlay modes, there are 2 separately controlled 
images: the VDC image and the DEB image. The 
2 images are combined on the display screen. Each 
pixel on the screen has 2 values associated with it: 
the VDC color and the DEB palette position. The 
LUT is used to resolve contention between the 2 
values associated with each pixel. 




DEB 
image 

page 128 



LUT 



Screen Display 
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The LUT for overlay modes looks like this: 





DEB 






Palette 




VDC Color 


Position 




= black 

1 = blue 

• 
• 




I 
1 
1 
1 

1 — , 


• 

15 = high 
intensity 
white 




This LUT entry contains the 
color that will appear on the 
screen for the particular 
combination of VDC color 
and DEB palette position 




As in the 16-color graphics modes, the locations in 
the LUT are numbered consecutively from left to 
right and top to bottom. For example, location 17 
corresponds to Row 2, Palette Position 0. 
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In the overlay modes, as in the 16-color graphics 
mode, the LUT is divided into time states that 
control blinking effects. However, in the overlay 
modes, the LUT is only divided into two time 
states. Half of the LUT determines what is being 
displayed at any time. The top half is used for the 
first Vi of each second and the bottom half is used 
for the second ¥2 of each second. 



Using the overlay modes, you create blinking by 
making the values in the top half of the table dif- 
ferent from the corresponding values in the bottom 
half of the table. 



DEB Palette Position 



LUT 
Row 







15 




16 



31 
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The following example shows the LUT values for 
standard Palette 2 of an overlay mode. The LUT is 
programmed so that the DEB image is displayed 
only if the VDC color is (black). If the VDC 
requests any other color, then that color is dis- 
played no matter what the DEB requests. This has 
the effect of overlaying the VDC image "on top" of 
the DEB image. 



DEB Palette Position 



t(0) 



VDC 
Color 



Values 


1 


2 


3 


4 


5 6 7 





0, 1, 


2, 


3, 


4, 


5, 6, 7, 


1 


1, 1, 


1, 


1, 


1, 


1, 1, 1, 


2 


2, 2, 


2, 


2, 


2, 


2, 2, 2, 


3 


3, 3, 


3, 


3, 


3, 


3, 3, 3, 


4 


4, 4, 


4, 


4, 


4, 


4, 4, 4, 


5 


5, 5, 


5, 


5, 


5, 


5, 5, 5, 


6 


6, 6, 


6, 


6, 


6, 


6, 6, 6, 


7 


7, 7, 


7, 


7, 


7, 


7, 7, 7, 


8 


8, 8, 


8, 


8, 


8, 


8, 8, 8, 


9 


9, 9, 


9, 


9, 


9, 


9, 9, 9, 


10 


10, 10, 10, 


10, 10, 10, 10, 10, 


11 


11,11,11,11,11,11,11,11, 


12 


12, 12, 12, 12, 12, 12, 12, 12, 


13 


13, 13, 13, 13, 13, 13, 13, 13, 


14 


14, 14, 14, 14, 14, 14, 14, 14, 


15 


15, 15, 15, 15, 15, 15, 15, 15, 
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DEB Palette Position 

VDC 
Color 
Values 



1 2 3 4 5 6 7 





1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



0, 

1, 
2, 
3, 
4, 
5, 
6, 
7, 
8, 
9, 
10, 
11, 
12, 
13, 
14, 
15, 



1, 2, 

1, 1, 

2, 2, 

3, 3, 

4, 4, 

5, 5, 

6, 6, 

7, 7, 

8, 8, 

9, 9, 
10, 10, 

11,11, 
12, 12, 
13, 13, 
14, 14, 
15, 15, 



3, 4, 5, 

1, 1, 1, 

2, 2, 2, 

3, 3, 3, 

4, 4, 4, 

5, 5, 5, 

6, 6, 6, 

7, 7, 7, 

8, 8, 8, 

9, 9, 9, 
10, 10, 10, 

11,11,11, 

12, 12, 12, 
13, 13, 13, 
14, 14, 14, 
15, 15, 15, 



6, 7, 

1, 1, 

2, 2, 

3, 3, 

4, 4, 

5, 5, 

6, 6, 

7, 7, 

8, 8, 

9, 9, 
10, 10, 
11,11, 
12, 12, 
13, 13, 
14, 14, 
15, 15, 
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In this example, the standard Palette 2 is modified 
so that position 2 is a blinking between blue (color 
1) and red (color 4). 



DEB Palette Position 



t(0) 



VDC 
Color 



T 7 1 

Values 





1 


2 


3 


4 


5 6 7 





0, 


1, 


1, 


3, 


4, 


5, 6, 7, 


1 


1, 


1, 


1, 


1, 


1, 


1, 1, 1, 


2 


2, 


2, 


2, 


2, 


2, 


2, 2, 2, 


3 


3, 


3, 


3, 


3, 


3, 


3, 3, 3, 


4 


4, 


4, 


4, 


4, 


4, 


4 4 4 


5 


5, 


5, 


5, 


5, 


5, 


5, 5, 5, 


6 


6, 


6, 


6, 


6, 


6, 


6, 6, 6, 


7 


V, 


7, 


7, 


7, 


7, 


7 7 7 


8 


8, 


8, 


8, 


8, 


8, 


8, 8, 8, 


9 


9, 


9, 


9, 


9, 


9, 


9, 9, 9, 


10 


10, 10, 10, 10, 10, 10, 10, 10, 


11 


11, 11, 11, 11, 11, 11, 11, 11, 


12 


12, 12,12, 12,12, 12, 12, 12, 


13 


13, 13,13,13,13,13, 13, 13, 


14 


14, 14, 14, 14, 14, 14, 14, 14, 


15 


15, 


15 


15, 


15 


15 


15, 15, 15, 
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DEB Palette Position 



VDC 
Color 



Values 





1 


2 


3 


4 


5 6 7 





0, 


1, 


4, 


3, 


4, 


5, 6, 7, 


1 


1, 


1, 


1, 


1, 


1, 


1, 1, 1, 


2 


2, 


2, 


2, 


2, 


2, 


2, 2, 2, 


3 


3, 


3, 


3, 


3, 


3, 


3, 3, 3, 


4 


4, 


4, 


4, 


4, 


4, 


4, 4, 4, 


5 


5, 


5, 


5, 


5, 


5, 


5, 5, 5, 


6 


6, 


6, 


6, 


6, 


6, 


6, 6, 6, 


7 


7, 


V, 


7, 


7, 


7, 


7 7 7 


8 
9 


8, 
9, 


8, 
9, 


8, 
9, 


8, 
9, 


8, 
9, 


8, 8, 8, 

9, 9, 9, 


10 


10, 10, 10, 10, 10, 10, 10, 10, 


11 


11, 11, 11, 11, 11, 11, 11, 11, 


12 


12, 


12, 12, 12, 


12, 12, 12, 12, 


13 


13, 13, 13, 13, 13, 13, 13, 13, 


14 


14, 14, 14, 14, 14, 14, 14, 14, 


15 


15,15, 15, 15, 15,15,15, 15, 
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In this example, values in the LUT cause the 
DEB's output to take precedence over the VDC's 
output. The VDC's output is only displayed when 
you specify DEB palette position in a graphics 
statement. 



DEB Palette Positions 



VUL 




uolor 




Values 


01234567 





0,1,2,3,4, 5, 6, 7, 


1 


1,1,2,3,4, 5, 6, 7, 


2 


2,1,2,3,4,5,6,7, 


3 


3,1,2,3,4,5,6,7, 


4 


4,1,2,3,4,5,6,7, 


5 


5,1,2,3,4,5,6,7, 


6 


6,1,2,3,4, 5, 6,7, 


7 


7,1,2,3,4,5,6, 7, 


8 


8,1,2,3,4, 5, 6, 7, 


9 


9,1,2,3,4,5,6, 7, 


10 


10,1,2,3,4,5,6, 7, 


11 


11,1,2,3,4,5,6,7, 


12 


12,1,2,3,4,5,6,7, 


13 


13,1,2,3,4,5,6,7, 


14 


14,1,2,3,4,5,6,7, 


15 


15,1,2,3,4,5,6,7, 
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DEB Palette Positions 

VDC 
Color 

Values 01234567 



1 


0,1,2,3,4,5,6, 


7, 


1 


0,1,2,3,4,5,6, 


7, 


2 


2,1,2,3,4,5,6, 


7, 


3 


3,1,2,3,4,5,6, 


7, 


4 


4,1,2,3,4,5,6, 


7, 


5 


5,1,2,3,4,5,6, 


7, 


6 


6,1,2,3,4,5,6, 


7, 


7 


7,1,2,3,4,5,6, 


7, 


8 


8,1,2,3,4,5,6, 


7, 


9 


9,1,2,3,4,5,6, 


7, 


10 


10,1,2,3,4,5,6, 


7, 


11 


11,1,2,3,4,5,6, 


7, 


12 


12,1,2,3,4,5,6, 


7, 


13 


13,1,2,3,4,5,6, 


7, 


14 


14,1,2,3,4,5,6, 


7, 


15 


15,1,2,3,4,5,6, 


7. 
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The following LUT entirely blocks out VDC output: 



DEB Palette Positions 

VDC 
Color 



Values 


1 


2 3 4 5 6 7 





0,1, 


2,3,4,5, 6, 7, 


1 


0,1, 


2,3,4, 5, 6, 7, 


2 


0,1, 


2,3,4, 5, 6, 7, 


3 


0,1, 


2,3,4, 5, 6, 7, 


4 


0,1, 


2,3,4, 5, 6, 7, 


5 


0,1, 


2,3,4, 5, 6,7, 


6 


0,1, 


2,3,4, 5, 6, 7, 


7 


0,1, 


2,3,4, 5, 6, 7, 


8 


0,1, 


2,3,4, 5, 6, 7, 


9 


0,1, 


2,3,4, 5, 6, 7, 


10 


0,1, 


2,3,4, 5, 6, 7, 


11 


0,1, 


2,3,4, 5, 6, 7, 


12 


0,1, 


2,3,4, 5, 6, 7, 


13 


0,1, 


2,3,4,5,6, 7, 


14 


0,1, 


2,3,4, 5, 6,7, 


15 


0,1, 


2,3,4,5,6,7, 
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DEB Palette Positions 

VDC 
Color 



t(l) 



alues 





1 


2 


3 


4 


5 


6 


7 





0, 


1 


2 


3 


4, 


5, 


6, 


7, 


1 


0, 


1, 


2 


3, 


4, 


5, 


6, 


7, 


2 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


3 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


4 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


5 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


6 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


7 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


8 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


9 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


10 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


11 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


12 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


13 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


14 


0, 


1, 


2, 


3, 


4, 


5, 


6, 


7, 


15 


0? 


1. 


2, 


3, 


4, 


5, 


6, 


7, 
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Programming the Bit Planes 



Introduction Once you have learned to program the LUT 

directly using the Set Color Palette command, you 
can make further use of the LUT's capabilities by 
programming the VDC and DEB video memory 
directly. 

By directly programming the video memory of the 
VDC and DEB boards, you can increase the graph- 
ics display speed. The values you load into the 
video memory planes determine how the LUT is 
accessed. This section assumes that you have read 
and understood how to program the LUT directly. 

In the 16-color graphics modes, the device driver 
combines the 3 bit planes of the DEB with one bit 
plane from the VDC to create the four bit planes 
necessary for 16-color graphics. 

In the overlay modes, the device driver uses the 3 
DEB bit planes for 8-color graphics output and 
uses the VDC board separately for either text or 
graphics output. 



A0000:0 



A8000:0 



B000:0 



B8000:0 



DEB Bitplane 


DEB Bitplane 
1 



DEB Bitplane 2 



VDC Bitplane 



Memory Map 
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LUT A LUT address is an 8-bit value that points to one 

Addressing of the 256 locations within the LUT. The method of 

address formation depends on the current video 

mode. 

For transparent and disabled modes, LUT address- 
ing is irrelevant. In the transparent mode, VDC 
color values bypass the LUT processing and go 
directly to the monitor output. In the disabled 
mode, all output from the LUT is forced to the 
value of zero. 

For the 16-color graphics and overlay modes, the 
LUT address is composed of bits from the DEB 
video bit planes, the VDC's video output, and DEB 
timing bits. 

Timing Bits The timing bits are called BLINKl, BLINK2, 
PATl, and PAT2. BLINKl and BLINK2 effect 
blinking; PATl and PAT2 effect patterning 
(dithering). 

All of the timing bits are applicable in the 16-color 
graphics mode; only BLINKl is part of the address 
formation in the overlay mode. Therefore, you have 
fewer options for blinking and no ability to dither 
in the overlay mode. 

The operation of the timing bits is very fundamen- 
tal to creation of special effects. The bits always 
cycle on and off, each at a different rate. BLINKl 
cycles on and off each 1/4 second. BLINK2 cycles 
on and off each 1/8 second. 
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PATl and PAT2 cycle on and off so fast that the eye 
cannot perceive a blink (PATl is the fastest). A 
dithered color is really 2-4 separate colors that are 
changing so rapidly that the eye perceives them as 
one solid color. 

PATl changes value at the same rate that the mon- 
itor's cathode ray moves from one pixel to the next. 
PATl's effect on LUT addressing is that it switches 
the address by 16 LUT entries — in the previous 
table, between pairs of rows. PAT2 changes value 
at the same rate that the cathode ray changes 
scanlines — in the previous table, between one 
pair of rows and the next pair of rows. 



PAT2 PATl Portion of LUT 

1st 16 entries of each quarter 

1 2nd 16 entries of each quarter 

1 3rd 16 entries of each quarter 
1 1 4th 1 6 entries of each quarter 
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To output a color to the monitor, the DEB concat- 
enates the DEB timing bits BLINKl, BLINK2, 
PATl, PAT2, the BLUE output bit from the VDC, 
and a bit from corresponding locations on each of 
the three DEB bit planes. 



Programming the LUT 



2. Overlay Mode 




DEB 
Timing 
bit 



IND Video Output 



DEB Video Ram 



IND 
HI- 
LIGHT 



00 



IND 
tJREENl 



IND 
RED 



11 



IND 
BLUE 



DEB 
VID 
2 



1 



DEB 
VID 
1 




4-bit 
Color Value 



MONITOR 



DEB 
VID 




8-bit 
LUT 
Address 



FF 



To output a color to the monitor, the DEB concat- 
enates the following bits: BLINKl, the HILIGHT, 
GREEN, RED, and BLUE output bits from the 
VDC, and a bit from corresponding locations on 
each of the three DEB bit planes. 
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Short LUT The DEB supports a method for you to access only 
Addresses the first sixteen LUT locations. This lets you use 
normal 16-color graphics without needing to man- 
age all of the 256 LUT locations. You invoke this 
short addressing mode by a setting bit 2 in AL in 
the "Set Color Palette" command. 



3. Short LUT Addresses 



DEB Mode Control Register 
7654 3 210 

bit3: 
(LITTLEBIT) 
1 = "BLOCK BITS" 
= "PASS BITS" 



8-bit 
LUT 
address 



DEB 
timing 
bits, 
IND 

board 

Output 

bits, 
DEB 

video 

RAM bits 



W 
I 
T 
C 
H 



4/8-bit 
LUT 
address 



OOh 



FFh 




5-39 



Programming the LUT 



4. Modes. Address Formation. & DEB Mode Control Re gister 
pbit7 I I I bit4 [ bits [ I I bitr| 



DEB 

timing bits 
BLKl. 
BLK2i 
PAT2 
PATl 



8-bit 
bits LUT 
1 = 0FF a 



bit? 
1 = 0N 
= OFF bitO 
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